大讨论:在java的开发过程中,大家都是用什么工具进行文档管理的?
引子:
文档是软件的重要组成部分,它在软件的开发、测试、维护等方面起着举足轻重的作用。但是,文档的书写又是一件极其枯燥的事情。JDK中有个命令:javadoc.exe可以根据代码中的注释自动生成文档,不过这需要在代码中添加大量的符合javadoc规范的注释。
现在大部分软件开发项目都需要很多人分工协作,这就引出了不同模块之间接口的协调问题。在很多情况下,接口并不是事先定义好的,而且迫于时间的压力,文档也不会写的很完善。在实现定义的接口,也很难保证实际代码会完全符合。
问题:
1.大家通过什么辅助工具书写文档和管理文档?
2.碰到哪些与文档有关的让人头痛的问题?
3.有没有碰到实际接口与事先定义的有出入的问题?又是怎么解决的?