注册 登录  
 加关注
   显示下一条  |  关闭
温馨提示!由于新浪微博认证机制调整,您的新浪微博帐号绑定已过期,请重新绑定!立即重新绑定新浪微博》  |  关闭

不透明的雾的博客

人生是一次记忆的旅行

 
 
 

日志

 
 
 
 

编程工作中文档管理的重要性  

2011-04-02 18:55:00|  分类: 原创 |  标签: |举报 |字号 订阅

  下载LOFTER 我的照片书  |

编程工作中文档管理的重要性

计算机编程是通过具有逻辑的一系列指令,控制计算机的运算,解决现实中的问题,文档是描述问题的方法和工具
所谓的编程工作,实际上是在围绕着需求走,无论是设计、编码、测试,一切编程活动的依据都是需求,文档是需求描述的沉淀和总结
文档贯穿了需求调研、系统设计、代码编写、测试维护等一系列的编程活动。

程序员也许会觉得,没有文档,我一样写出了很好的程序。
很多人包括我自己在内很多时间在没有文档的情况下也直接编写出可以运行的代码
往往改来改去一个程序就可以编写出来,似乎没什么难的,但是有时候也会发现出现一些难以预料的事情,让程序变得难以维护
这难道是因为没有写文档在作怪么?

其实,直接开始编程能否成功往往取决于需求规模的大小
没有写文档并不代表文档不存在,只不过直接在程序员的大脑里呈现而已
一个人独自工作而且需求不是很复杂的时候,大脑可以记住几乎所有的关键之处
即便是忘掉了几处,一旦稍微回想就能大概整理出思路
然而当一个软件的需求逐渐开始复杂,更多人的加入到开发中的时候
两个人的脑子可不会自动的进行同步,而且系统中的点越来越多,仅凭大脑似乎无法胜任了
开会是多个项目参与人员同步大脑的好方法,除了沟通之外,还可以产生很多奇思妙想

如果没有文档记录下来,往往是说的时候知道,真正具体到实际工作又忘掉了,又需要进行二次沟通,甚至更多次沟通
无形之间就浪费了时间,加之没有经验的程序员如果按照自己理解的一套东西做,往往还需要返工,这对于项目来说都是不可控制的风险
文档的好处就在于将随口一说的话固定下来 形成文字
不管什么时间拿出来文字不变,描述的含义就不变
能够尽可能避免上面所说的多人沟通效率低下,需求复杂后无法建立全局观念等问题
今天先想到这里,下次在考虑考虑关于文档编制过程中的方法和技巧问题。

  评论这张
 
阅读(83)| 评论(0)
推荐 转载

历史上的今天

评论

<#--最新日志,群博日志--> <#--推荐日志--> <#--引用记录--> <#--博主推荐--> <#--随机阅读--> <#--首页推荐--> <#--历史上的今天--> <#--被推荐日志--> <#--上一篇,下一篇--> <#-- 热度 --> <#-- 网易新闻广告 --> <#--右边模块结构--> <#--评论模块结构--> <#--引用模块结构--> <#--博主发起的投票-->
 
 
 
 
 
 
 
 
 
 
 
 
 
 

页脚

网易公司版权所有 ©1997-2017