文档的作用和分类

海的女儿 · 发表于 2004-9-2 15:05:19

QA都不希望自己像文档管理员般的工作，但是换个角度想想，一个不规范的软件企业，QA的领导能力再强又有何用，对于这个“不规范”的一个明显例子就是文档上的欠缺。在没有人做，实在看不下去，并且你还愿意在公司继续待下去的情况下，还是把这一块抓起来吧！

wangnan · 发表于 2004-9-2 15:41:57

是啊！好多的软件开发人员都不愿意写文档，
认为那是在浪费时间
有几次我和他们沟通，问他们为什么不愿意写文档？
他们用很奇怪的眼神望着我说，
我们对文档没兴趣，思想在脑子里，编码才是关键
写文档，写了也不见得真的那样去做，而且改来该去多麻烦
如果你不嫌烦，你帮我们写得了
气的我差点没吐血！
真是，这世道做什么都难！

skinapi · 发表于 2004-9-2 19:20:42

非常感谢海的女儿共享的这篇文档。
关于项目组成员（包括开发人员和测试人员）不喜欢写文档，个人觉得有一下一些原因：
1。人的惰性，需要通过制度和流程来尽量避免。
2。写文档不方便，比如我们公司都是用word来写文档，可不少开发人员都抱怨写起来不方便，特别是写伪码时，编写和修改都不方便。需要考虑如何让写文档更方便、简洁。
3。不知道怎样写才能简单明了，需要对项目成员进行写作方面的培训。
个人观点，欢迎讨论。

海的女儿 · 发表于 2004-9-7 08:48:54

我一向坚持这样的观点：如果说开发人员不屑写文档，但可以为我们打造出精美的软件，我同样很佩服他们，但是，往往拿到测试人员那边的软件连某些正确操作都会报错，叫人实在寒心，不知道他们的精力投入的含金量真的有多少；
对于文档用什么工具来写，目前大多数公司都是用word或excel。当然，如果能用具有针对性的管理工具进行书写及管理会更好，但是好多公司又不太愿意去买或自己去研发这样的工具，所有矛盾总是存在！

smallfish382 · 发表于 2004-9-8 09:48:20

大家都说得有理啊。写文档，开发人员都认为那只是应付一下，哪会按照那个去做啊。
　　　真是郁闷啊

yi3310 · 发表于 2004-9-8 11:09:32

谢谢你的文档,我下了,打开一看,很有用的.谢谢!

海的女儿 · 发表于 2004-9-13 08:52:17

有效地写文档是目前必须解决的问题之一，但急不来，还需要提高文档模板质量、转变做文档态度等的时间

lookmezh · 发表于 2004-10-19 10:07:40

文档的管理很大一部分是模版的管理.呵呵.

yy903 · 发表于 2004-10-19 15:07:28

谢谢！

beiyue · 发表于 2004-10-20 13:44:28

非常感谢版主的资料,个人认为这个也非常重要,但我目前所在公司也是不写文档,这样出现的问题不是一俩话能说清楚的,连目分析,设计人员都不写,那到了编码\测试人员更糟糕,编码人员每做一点事情都得去问设计人员关于业务流程方面的问题,结果是对是错说不清楚;测试人员可能什么也不清楚

beiyue · 发表于 2004-10-20 13:47:10

有了问题,至少责任明确,交流方便,工作有头绪,至于文档质量的提高可能需要一个过程

rosycloud · 发表于 2004-10-25 15:35:15

QA要能工作好,发挥作用,一个首要的前提就是领导能够重视要软件过程规范和文档完整的重要性,否则QA人员根本没法工作.很多开发人员对QA人员的工作都有抵触情绪,他们根本不愿意把自己的思路用文档的形式表达出来.这点必须要有强制性.

duzhy · 发表于 2004-10-31 19:21:36

文档的完善和管理有很大的关系，人都是有惰性的。没有督促和考核，是没有人喜欢写文档的。

luoyear · 发表于 2004-11-1 13:28:59

如果上下游的接口作用必须靠文档去传递
那么
逼迫写文档的好好去写
读文档的认真去用
所以目前国内文档书写最好的部分肯定是用户手册
最糟糕的部分肯定是设计文档

xiaojinzi · 发表于 2004-11-4 11:12:34

谢谢。

zjm0326 · 发表于 2004-11-5 17:21:28

谢谢海的女儿，对我参与评审很有用

luckyfish · 发表于 2004-11-15 11:34:02

最近公司要把文档管理提到议程上来，现在想找一个好的文档管理工具，除了vss外，有没有其他好的，推荐一下，谢谢！

luoyear · 发表于 2004-11-17 12:42:48

Originally posted by luckyfish at 2004-11-15 11:34 AM:
最近公司要把文档管理提到议程上来，现在想找一个好的文档管理工具，除了vss外，有没有其他好的，推荐一下，谢谢！

制度

tempuser · 发表于 2004-11-18 15:12:31

应该先写文档再开发，然后再补充修正文档

jacobs · 发表于 2005-10-24 14:25:49

Originally posted by luckyfish at 2004-11-15 11:34:
最近公司要把文档管理提到议程上来，现在想找一个好的文档管理工具，除了vss外，有没有其他好的，推荐一下，谢谢！

CVS

		自动登录	找回密码
密码			(注-册)加入51Testing

[讨论] 文档的作用和分类

本帖子中包含更多资源

相关帖子

多谢！

documentation

documentation

有没有什么好的文档管理工具？

站长推荐 /1