文档的作用和分类

kuaiking

不愿意写文档的开发人员注定只能当一辈子code worker了..

langchu

这也就是为什么人员结构总是金字塔形的原因了，哈哈

muzi

综合指数为零,下不了!~
强烈抗议管理员的这种行为.人家发资料来给大家用的,管理员反而限制不让我们新手用.
抗议!~抗议~!

冬听雪

现在刚开始做QA的工作，还在不断学习中，但是觉得文档不管是对测试还是对整个项目的质量控制都起着至关重要的作用。

winter0220

我觉得在对日软件公司这块还是做的挺好的，因为不得不承认日本人他们的软件开发思想和过程控制比我们高很多，对文档他们的要求是很严格的，所以中方公司在被强制写一些文档后，公司里的领导和员工也都慢慢有了写文档的意识。
所以说写文档，我觉得还是要有一个强制的过程，慢慢大家发现这样做的好处了就会自觉去做了！

weimj2008

原帖由 langchu 于 2007-4-11 13:59 发表
我是搞开发的，文档的事情我是这么感觉的
1.很多公司的项目本身就决定了是在赶项目，开发都不一定时间够，更何况写文档的时间
2.很多公司在制度上对文档根本就没有保证，靠个人来推行文档肯定是很困难的
3.的 ...

非常典型的说法。
我从事软件开发12年，连详细设计文档都完全做好，我负责的项目就会延期？
很多人认为写文档浪费时间，这个想法与“读大一不如直接读大四”的想法基本一致。

crystalpear

总觉得开发人员无法理解测试人员的辛苦

h220000

我的上级也是这样,刚开始很郁闷,后来自己在工作中找到一些问题点,主动跟老板沟通交流,几次下来,现在也开始重视文档这一块了

[ 本帖最后由 h220000 于 2007-5-14 15:09 编辑 ]

zgslhyh

没权限下，，，

lixllizi

我们公司这点做得还不错

kilen_he

同一楼上的观点

swallowlly

以前做过开发，也写过文档，如果从流程上强调文档的重要性，大部分开发人员都不会正真的写好。
提高项目质量，流程是一方面，最重要的还是提高项目开发人员的能力

zuojingqin

是的,我现在才觉得一个公司的流程化管理真的好难,有些领导认识是必须做的,可是,有些领导觉得多一个测试人员没什么必要,而且,还认为有了测试人员就必须包证没有BUG出现?你们认为这合理吗????

高跟鞋跳舞

没有文档,需求变了,测试人员都不知道.

春雨蒙蒙的下

我也曾经做个开发，个人觉得文档十分必要。
（1）对自己后期修改工作很重要，好记性不如烂笔头，这句话没错；
（2）与项目实施人员工作交接的重要内容；很多时候，开发人员在项目交接时不提供这些文档，项目实施人员实施中遇到问题，直接向开发人员咨询，这时又浪费开发人员的时间，又耽误实施进度，其实只要文档维护好，实施人员实施前认真学习就可以避免；
（3）对接手工作的人有益处，开发设计时的详细设计文档或概要设计文档对接手维护工作的其他人无疑是救命的，如果没有这些，他即使阅读代码能力超强也很难掌握你的思路和方法。

linglingqiu

谢谢海的女儿

china110

三大

snowyer2004

我怎么下载不了了
晕

yiding_he

我是一名开发人员。我是这样看的：
1、文档的作用，不可否认。项目是大家一起做的，所以沟通少不了。文档的目的就是沟通和记载。“源代码是最好的设计文档”的说法虽有争议，但该说法也仅限于设计文档。总之项目当中文档是必不可少的。

2、文档的形式，是否一定要用 Word 文档（或者 wps、odf 等），其他形式（网页、Excel、数据库等）是否可以？通常人们都认为文档应当以描述性的文字为主，结构化的数据人们都不看作是文档。这样的态度我认为不正确。如果这些内容就是用于项目的沟通和记载的，那么都应看作文档。

3、文档的编写，是否一定要手工编写？很多报表其实都是“数据+模板”生成的，某些文档是否可以参考这种方式？如果我可以查到指定开发人员这个星期修复的 BUG 列表，那么我还需要让每个开发人员写文档告诉我这个星期修复了那些 BUG 吗？如果我可以用工具生成 UML，我还需要在 Word 里面一个一个方框的画吗？



写文档又不用怎么动脑子，如果每天只要做八小时，我都恨不得把文档写成水浒传，程序？慢慢来。但是如果今天非要把这个功能完成不可，我可不想加班。代码能省吗？省不得。那怎么办？只好在文档上偷点懒咯。

Jennyezkj

谢谢分享！我也觉得一个测试项目的文档管理环节很重要。不但有条理，比较规范还起到总结的作用。