文档的作用和分类

jacobs · 发表于 2005-10-24 14:30:03

大家觉得文档模板的管理如果按照测试周期的不同阶段来管理怎样？

韩冰冰 · 发表于 2005-12-11 20:19:53

但是在实际的工作中,很多公司都是项目完毕之后才有相关文档,我也碰到这种情况,头痛!!

Linda_123 · 发表于 2006-2-14 17:07:45

写文档的本质是为了交流, 为了将信息准确的记录下来并传达给其他人。开发人员之所以反感文档本人人为原因有以下几点：
1。认为文档写起来太费时间
2。真正需要的文档很容易跟不上更新的节奏，不能真正起到准确交流的作用
3。某些公司的文档过多，过于烦杂，实际的作用不是很大
所以本人认为：如果能够加强交流，撰写必要的文档，减少或者简单化部分文档，对一些公司来说更好。
不要把简单的事情复杂化。

海的女儿 · 发表于 2006-2-15 16:22:40

……
"1。认为文档写起来太费时间
2。真正需要的文档很容易跟不上更新的节奏，不能真正起到准确交流的作用
3。某些公司的文档过多，过于烦杂，实际的作用不是很大"
……
出现这些问题,1、不会写文档，就好象不会写作文一样；2、不会管理文档，所以更新跟不上。3、不会制定流程，所以闲杂文档过多。

Linda_123 · 发表于 2006-2-22 16:15:43

海的女儿分析的很正确.
这是很多公司现实中出现的问题. 是个恶性的循环. 不合适的流程导致闲杂文档过多, 而文档管理上的欠缺就不能真正发挥文档的作用. 而不会写文档又使的程序员更加厌烦写文档.
现实中三者的平衡并非容易.........

meirain · 发表于 2006-3-9 22:30:54

有知识管理，协作和文档管理功能。

http://www.czsm.com.cn/product/confluence.htm

peiyan419 · 发表于 2006-3-15 11:02:49

看了各位上面的讨论，真是受益不浅．我刚入ＩＴ这个行业不到一个月，应聘的职位是文档工程师，其实我对这方面的知识知道的甚少，就全当一个跳板一个学习的机会．现在公司的情况很不规范，刚从母公司分出来的，呵呵，上司又是一个很＂搞乐＂的人，他没有明确安排我的工作，现在项目组在外地封闭开发，看着大家都很忙，我却无所事事，根本没有人去写文档，我好不容易弄出来的文档模板也用不上．上级说过些时候带着我做测试，这样的上级，不知是幸运还是不幸，什么都自己摸着走，没人告诉我要做什么，应该做什么！

rrazz · 发表于 2006-3-15 11:23:43

文档的重要性很多的开发工程师未必能意识到，我的个人建议:
1.如果整个公司在制度上就做了硬性规定,强调了不写文档的风险,慢慢大家都会养成习惯,这一点是不管用CVS还是VSS都没发比的.
2.设计文档格式的时候,例如在EXCEL里只需简单的调用宏,就可以实现一些小功能,这样也会方便大家的书写.
3.设计文档或者处理文档给大家的印象好像都是打杂的干,这都是IT业界存在的误区,文档书写都是基本,一切都是要从细节基本做起

peiyan419 · 发表于 2006-3-15 11:47:15

呵呵，我现在就觉得自己是打杂的．
上级一点也不与我沟通，我也不知道怎么下手去开展工作，这样无所事事也不是办法．

Ereese · 发表于 2006-6-25 12:09:41

xiexie!

yangxiaowen0622 · 发表于 2006-6-26 18:24:53

写文档是要了开发人员的命。这是我在工作时候的总结。每次到催文档的时候。象讨债似的。总结下来。要有好的文档。领导的支持是关键。模板的简洁是基础。希望自己不要再当债主了

firemonth · 发表于 2006-7-25 00:36:15

了解目的，具体问题具体分析，文档因公司而异。

丰先生 · 发表于 2006-7-25 10:31:33

对于QA人员来说，要保证公司能产出高质量的文档（包括开发、测试文档）的确不是件容易的事。需求有步骤地要求、持之以恒地监督，逐步提高文档质量。当然过程中还要提供必要的帮助，比如有文档模板等。

1、宣导文档重要性的理念，辅以公司的强制推行措施。

2、理解他们转变时的痛苦，为他们争取写文档的时间，为他们提供文档模板。最重要
的是开始不要要求太高，能依葫芦画瓢，有文档产生，这一阶段的任务就算完成了。

3、等多数人都有了写文档的概念后，就要开始不知不觉要求文档的质量了。可以通过
检视、评审提出这种要求，这一步的文档质量就必须是言之有物，并且比较规范。

4、最后一步就是要求文档完全规范，文档书写认真、严谨，不能有错别字之类的“细节问题”
，可以从文档产生的流程上强制规范，比如文档产生后，必须通过哪些检视，甚至可以与
KPI挂钩等。sdlkfj5

[[i] 本帖最后由丰先生于 2006-7-25 10:36 编辑 [/i]]

mengxb001 · 发表于 2006-7-25 11:38:26

看来我目前公司还是比较幸运的了

ldneliza · 发表于 2006-7-28 11:22:06

没写过，学习先。

ClarkZhao · 发表于 2006-8-1 17:04:33

拜读ing!

kathine · 发表于 2006-8-3 11:31:23

我现在的处境和peiyun419一样，很茫然，希望高手指点。

cindyhuipeng · 发表于 2006-12-14 15:10:39

与开发人员沟通还是挺困难的，大家只能尽量的相互理解了

byonie · 发表于 2007-4-11 11:19:40

我认为文档其实是开发中很重要的一部分，可是开发人员却很不重视。现在急需提高他们的意识。

langchu · 发表于 2007-4-11 13:59:26

我是搞开发的，文档的事情我是这么感觉的
1.很多公司的项目本身就决定了是在赶项目，开发都不一定时间够，更何况写文档的时间
2.很多公司在制度上对文档根本就没有保证，靠个人来推行文档肯定是很困难的
3.的确很多人都不会写文档，但是也没有人来教开发人员怎么写文档，很多开发人员是想写好文档的，只是不知道该怎么写，久而久之，也就不愿意写文档

总之啦，我感觉是大环境的原因，也许等软件从业人员的整体素质都上来之后，这种情况就会改变吧

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

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

推荐你用一个专业的企业级wiki软件：CONFLUENCE

写文档是要了开发人员的命

站长推荐 /1