码迷,mamicode.com
首页 > 其他好文 > 详细

论文档的重要性

时间:2015-10-17 00:32:10      阅读:195      评论:0      收藏:0      [点我收藏+]

标签:

为什么我要说这个话题呢?因为他让我感到失望和彷徨,顺便想吐槽不快,到底文档在我们项目中占据着多大重要性呢?有的小公司根本从项目的立项到研发再到项目结束,至始至终都没有一份完整像样的文档,这是让后来的人来接手维护项目最痛苦的事情。为什么会这样呢?我个人的看法是懒不想写,嫌麻烦,感觉是费力不讨好的事情或者根本不会写。我觉得最核心的问题就是懒不想写,根本就不想站在公司长远发展的角度去考虑问题,只顾眼前利益,或者说根本没有想做强做大的决心,只想墨守成规不想改变现状,我认为这样的公司只能小打小闹,永远成不了大气候。

我其实也是非常讨厌写文档,觉得麻烦,没有必要去写,现在我慢慢体会到写文档的重要性。当然不能为写文档而去写档,那么失去意义,那样我就认为完全没有必要去写。我不认为小公司就不用去写文档,而将关注点放在编码上,我认为这是不可取的,我认为文档和编码是同等重要的,甚至超过编码重要性。写文档的好处:1、降低项目依赖人的重要性,不会因为人员流动而导致项目无法正常运转,也可以让接手项目的人,快速上手;2、可以提高人的写作、语言组织能力;3、可追溯性,不至于有问题无从查起,做到有理有据;写文档的坏处就是耗时费力,需要花很大的经力去维护,当然从短期来看确实不是一件什么好的事情,但是从长远来看很有必要的,他将是整个软件研发过程的依据,有良好的追溯性,不至于过很长一段时间忘记这是做什么的。所以在我提出要写文档的时候为什么有人是抗拒的,我感到无法理解,于公于私都是对大家都有好处,可惜被抗拒,我很不理解这是为什么,想推动公司从管理、技术方面到更高一个层次,可惜我凭我个人之力很难做到。我现在是得过且过,还是继续坚持自已的原则,还是伺机而动呢?今天让我有这种冲动,因为感觉公司跟自已想法有些出入,没有什么成长性可言,只能混混时间,那违背了我的初衷。我只是希望能与公司同发展,共进步,不是止步不前,呆在原地不动,得过且过的想法。如果要是这样那我就不出来折腾。

那怎样才能写一篇清晰、严谨的文档呢?简述一下注意事项如下:

1、要控制文档书写格式;

2、控制文档中章节、段落字体大小以及边距;

3、尽量在文档排版上清晰明了;

4、在内容上要简明扼要,客观陈述,不带有个人感情色彩;

5、尽量在写文档的时候不要出现语气词,那样显得非常不严谨;

6、写内容的时候先列好提纲,整理出大概思路等等。

论文档的重要性

标签:

原文地址:http://www.cnblogs.com/CREN/p/4886699.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!