27.2(2/2)

作品:《我的上海老婆

再说话了,他才说道:这样,小伍,等到你们下次和甲方一起开需求会的时候,我也参加。行吧?”

“这当然太好了啊,还有什么行不行的?!”伍涛马上笑道。

这个事情讲完,又有一个小组长开始汇报。

他说的这件事情,仍然是在上次会议上就已经提到过的关于文档的问题。

“毫不夸张地说,不管是谁切分的不带说明文档的代码,或者是维护没有开发文档的旧软件对我而言就是个噩梦。”

这位组长说道,“在座的各位都知道,能坐下来理解一段没有良好文档,或注释的已有代码,本来就是很困难的。但是,如果连文档或注释都没有,那就更糟了。”

缺失好的文档,甚至没有文档。上海分公司里的这种状况王有节也是他工作时间久了以后才知道的。

但是,要知道,对大多数程序员来说,不管自己喜欢不喜欢,他们有时候也必须在别人的代码上继续工作。这时候,即使是一段有良好文档的第三方代码,都有可能也会变成一件麻烦事,它要求你做调试,重构,或结构化,使代码适应可能几个月前就已切分好的代码。

对于代码的编辑,每个程序员都有他们自己的一个独特的编码风格。所以每个程序员看其他人的代码几乎都是烂代码。而一旦有程序员跳槽就必然会有其他程序员接手他的项目,然而看着这些代码,特别还是那些不写注释的代码时,你就能知道程序员的头发其实很多时候都是被他们自己给抓光的。

可能还不止于此。

代码好不容易写完了,刚刚喘口气,准备开始下一个工作,公司领导却说,把文档也补一下,接口参数的含义都写上。这时候程序员心里通常都会不爽,有所抵触,结果自然就是草草地写个文档出来。

为什么这样呢,因为实现功能的那些代码才是体现自己价值的,能够赚钱的工作,文档看起来只是附加品而已。工作做完了,谁愿意多干活呢?

再说了,工作量估算的时候把写文档时间算进去了吗?你都不给我时间,现在还让我写,不是让我加班吗?

王有节在很久以前,就曾经向于经理和分公司建议:“如果想把工作做得漂漂亮亮,既有优雅的代码,又有完善的文档,必须得给文档工作留出时间才行。”

想了会儿,正要开口说话,“滴----”,有短信进来。王有节低头一看,却是布礼:你的时间能定下来了吗?
本章已完成! 我的上海老婆 最新章节27.2,网址:https://www.88gp.org/124/124670/128.html