黑马程序员技术交流社区

标题: 高水平的程序员有30%的工作时间用来写技术文档，是这样吗. [打印本页]

作者: 李复安 时间: 2013-6-18 05:47
标题: 高水平的程序员有30%的工作时间用来写技术文档，是这样吗.
看到一篇文章上说：
高水平的程序员从来不写文档的肯定是乳臭未干的毛孩子，
良好的文档是正规研发流程中非常重要的环节，
作为代码程序员，30%的工作时间写技术文档是很正常的，
而作为高级程序员和系统分析员，这个比例还要高很多。
缺乏文档，一个软件系统就缺乏生命力，
在未来的查错，升级以及模块的复用是就都会遇到极大的麻烦。

请问大家：
（1）写技术文档真的需要30%这么多时间吗？
（2）工作的时候写技术文档有哪些要求或者规范可以参考？

谢谢黑马兄弟姐妹们解答我的疑问、

作者: 梦想蓝色天空 时间: 2013-6-18 08:00
我工作经验一年左右，也写过一点关于自己的项目的文档，写文档30%这个时间差不多甚至更多，在写文档之前就必须要进行的工作有项目需求的分析、数据库的设计、项目的设计等，一个项目做的怎么样关键在于项目设计的怎么样，而不是项目写的怎么样，所以设计时大概占项目开发的35%-40%左右的时间，只要设计完成了，开发的速度我感觉还是很快的。。等这些设计时或设计完成后就必须要有一套完整的说明性的文档，供开发使用和做为交付物给客户。一般开发涉及的文档有：项目需求说明书，项目设计说明书，数据库设计说明书这些规范性的文档网上还是不少的。

作者: 韩明海 时间: 2013-6-18 08:57
这个也要看你在什么公司？很多小公司几乎没有文档，有个健全的函数说明就不错了。

作者: 李复安 时间: 2013-6-18 12:35

梦想蓝色天空发表于 2013-6-18 08:00
我工作经验一年左右，也写过一点关于自己的项目的文档，写文档30%这个时间差不多甚至更多，在写文档之前就 ...

谢谢前辈

作者: 李复安 时间: 2013-6-18 12:36

韩明海发表于 2013-6-18 08:57
这个也要看你在什么公司？很多小公司几乎没有文档，有个健全的函数说明就不错了。 ...

原来这样啊

作者: 袁梦希 时间: 2013-6-18 13:30
加油吧哥们

作者: 袁梦希 时间: 2013-6-18 13:30

梦想蓝色天空发表于 2013-6-18 08:00
我工作经验一年左右，也写过一点关于自己的项目的文档，写文档30%这个时间差不多甚至更多，在写文档之前就 ...

前辈加油

作者: 李复安 时间: 2013-6-18 16:35

袁梦希发表于 2013-6-18 13:30
加油吧哥们

多谢团长鼓励、:loveliness:

作者: 李复安 时间: 2013-6-18 23:18

pys200603027 发表于 2013-6-18 22:45
其实从软件工程来看，编码仅仅占整个软件生命周期的五分之一，
需求分析，概要设计，详细设计，编码实现， ...

很有用，谢谢、

欢迎光临黑马程序员技术交流社区 (http://bbs.itheima.com/)

黑马程序员IT技术论坛 X3.2