论坛首页 综合技术论坛

文档,重要?不重要?有多重要?

浏览 15209 次
精华帖 (0) :: 良好帖 (0) :: 新手帖 (0) :: 隐藏帖 (0)
作者 正文
   发表时间:2006-09-13  
温柔一刀 写道
写文档狠枯燥累人



写代码的能力,在公司里面不容易体现出来,因为一般没人去看你的代码,只有等你走了以后,维护的人会去看,写得好的话他受益; 写文档的能力,就比较容易体现出来些,在开发过程中你上面的人及你的开发伙伴基本上都会看看的。 是有点个人功利的思想,但这不是大部分的现状么?


当然,文档要与否要看其必要性,必要性是由环境决定的。 如果只是应付什么审计,或者没有什么可预见的读者,那自然很枯燥,其质量和功效也别指望高到哪里去。
0 请登录后投票
   发表时间:2006-09-13  
number017 写道
我现在项目组的项目经理是一位大学里面的知名教授,言必称对象,整天自己趴在那边写文档,然后交给下面人开发。底下人也不敢去问他,因为他很会骂人,结果很多误导。概要设计、详细设计...其实都是一堆垃圾。开发人员谁也不会去看那个。典型的文档驱动开发。结果是项目一推再推,而那位教授,也把责任推给其他人,因为他是知名的。唉...

我认为有用的文档包含用户手册(这个相当重要,拿给客户直接可以看出你专业不专业)。还有一份比较简洁的技术说明或者业务介绍,每个新来的同事看这份文档就可以比较快速的,或者是有帮助的融入进来。


好象很有趣哦 这样的文档我很想看到呢
0 请登录后投票
   发表时间:2006-09-14  
个人认为文档还是很重要的,特别是对于大型长期的项目。
0 请登录后投票
   发表时间:2006-09-15  
对于业务系统开发而言,
对内:str(业务需求文档)和srs(系统需求文档)是最为重要的.
对外:前面的xd提到的,用户手册/培训文档等.
0 请登录后投票
   发表时间:2006-11-02  
我觉得写文档真的是很重要的,特别是对中途加入项目组的开发人员来说,很有帮助的,我深有体会,好多需求什么的都只能通过文档来了解了
0 请登录后投票
   发表时间:2006-11-02  
除了需求文档,概要设计文档,用户手册之外,其他的(如详细设计)似乎并不重要,而且最要命的无法同步更新,形同鸡肋。

还是XP好呀
0 请登录后投票
   发表时间:2006-11-06  
代码可以通过Unit test来verify, 详细设计文档可以么?

只有写不出好代码的人,写不出Unit test的人才注重详细设计文档。因为文档写的好不好没有人说的清楚。

东郭先生也是这么想的。
0 请登录后投票
   发表时间:2006-11-06  
只要客户给钱 给时间 ,写一年又有什么
0 请登录后投票
   发表时间:2006-11-07  
越做项目,越重视文档。
当然,这不是指的形而上学的文档。
0 请登录后投票
   发表时间:2006-11-07  
风雪涟漪 写道
只要客户给钱 给时间 ,写一年又有什么

那是给自己的方便关客户什么事?
维护时哭天天不应叫地地不灵.
0 请登录后投票
论坛首页 综合技术版

跳转论坛:
Global site tag (gtag.js) - Google Analytics