锁定老帖子 主题:文档,重要?不重要?有多重要?
精华帖 (0) :: 良好帖 (0) :: 新手帖 (0) :: 隐藏帖 (0)
|
|
---|---|
作者 | 正文 |
发表时间:2006-09-13
温柔一刀 写道 写文档狠枯燥累人
写代码的能力,在公司里面不容易体现出来,因为一般没人去看你的代码,只有等你走了以后,维护的人会去看,写得好的话他受益; 写文档的能力,就比较容易体现出来些,在开发过程中你上面的人及你的开发伙伴基本上都会看看的。 是有点个人功利的思想,但这不是大部分的现状么? 当然,文档要与否要看其必要性,必要性是由环境决定的。 如果只是应付什么审计,或者没有什么可预见的读者,那自然很枯燥,其质量和功效也别指望高到哪里去。 |
|
返回顶楼 | |
发表时间:2006-09-13
number017 写道 我现在项目组的项目经理是一位大学里面的知名教授,言必称对象,整天自己趴在那边写文档,然后交给下面人开发。底下人也不敢去问他,因为他很会骂人,结果很多误导。概要设计、详细设计...其实都是一堆垃圾。开发人员谁也不会去看那个。典型的文档驱动开发。结果是项目一推再推,而那位教授,也把责任推给其他人,因为他是知名的。唉...
我认为有用的文档包含用户手册(这个相当重要,拿给客户直接可以看出你专业不专业)。还有一份比较简洁的技术说明或者业务介绍,每个新来的同事看这份文档就可以比较快速的,或者是有帮助的融入进来。 好象很有趣哦 这样的文档我很想看到呢 |
|
返回顶楼 | |
发表时间:2006-09-14
个人认为文档还是很重要的,特别是对于大型长期的项目。
|
|
返回顶楼 | |
发表时间:2006-09-15
对于业务系统开发而言,
对内:str(业务需求文档)和srs(系统需求文档)是最为重要的. 对外:前面的xd提到的,用户手册/培训文档等. |
|
返回顶楼 | |
发表时间:2006-11-02
我觉得写文档真的是很重要的,特别是对中途加入项目组的开发人员来说,很有帮助的,我深有体会,好多需求什么的都只能通过文档来了解了
|
|
返回顶楼 | |
发表时间:2006-11-02
除了需求文档,概要设计文档,用户手册之外,其他的(如详细设计)似乎并不重要,而且最要命的无法同步更新,形同鸡肋。
还是XP好呀 |
|
返回顶楼 | |
发表时间:2006-11-06
代码可以通过Unit test来verify, 详细设计文档可以么?
只有写不出好代码的人,写不出Unit test的人才注重详细设计文档。因为文档写的好不好没有人说的清楚。 东郭先生也是这么想的。 |
|
返回顶楼 | |
发表时间:2006-11-06
只要客户给钱 给时间 ,写一年又有什么
|
|
返回顶楼 | |
发表时间:2006-11-07
越做项目,越重视文档。
当然,这不是指的形而上学的文档。 |
|
返回顶楼 | |
发表时间:2006-11-07
风雪涟漪 写道 只要客户给钱 给时间 ,写一年又有什么
那是给自己的方便关客户什么事? 维护时哭天天不应叫地地不灵. |
|
返回顶楼 | |