27.2-《我的上海老布》


    第(3/3)页

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

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

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

    可能还不止于此。

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

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

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

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

    想了会儿,正要开口说话,“滴----”,有短信进来。王有节低头一看,却是布礼:你的时间能定下来了吗?


    第(3/3)页