什么是文档?(初学者的问题)
经常在各种书刊上看到如"程序员30%的时间是写文档"等,我不明白什么是文档.
各位大侠,能给我一个完美的答复么,最好能给出几个例子.
Thank you very much.
[解决办法]
描述软件开发过程的文字性的东西
[解决办法]
没有配套的同步、逆向工具文档就是垃圾,有毒垃圾!当然罗程序交付以后才补写的文档除外 :P
[解决办法]
过程控制,资源配置,分析报告,用户手册等等了
[解决办法]
你自己用的 老板用的 客户用的 文字性的东西都可以叫文档 而且在敏捷的方法看来 code是最好的文档
[解决办法]
描述软件开发过程的文字性的东西,如设计说明书,测试用例等
描述软件使用的文字性东西,如用户使用指南等
[解决办法]
推荐你学习PSP、TSP和RUP,你就学会如何写文档了。
=======================================================
**********
* 陵 * 徐 * 水无常形,兵无常式,只有变化是永恒的。
**********
* 印 * 子 *
**********
[解决办法]
描述软件开发过程和使用方法的……
[解决办法]
现代软件产品=文档+Code+过程数据
[解决办法]
文档是这样的一些文字,图表或数据:
1.用于更好地理解
2.用于明白地交流(人之间,机器之间,人与机器之间)
code其实也是一种文档
[解决办法]
本质:能够人与人(当前的,后来的)交流的,便于理解的结构化,规范化的信息。
[解决办法]
项目做完了,一年后要重新维护,这时候,原来到开发人员都走了,怎么维护?光看代码是不成的,所以,以前的文档就很重要。
文档,就是方便理解这个项目的文字,图表等说明。通过它,可以方便地理解项目,维护项目。
一个项目需要什么样的文档,你可以看软件工程的书,上面讲得很详细。但文档是可多可少的,应根据不同情况做取舍。这个度,只能通过实际经验来把握,没有什么窍门可讲的。