一个菜鸟程序员的五年职场路

8 —— 文档

董延明从外面归来的时候已经天气大热了，他受到了吴博士一干人的热烈欢迎，吴博士掏出十块钱来，“董啊，去买雪糕去，你走了都没有人去买雪糕了……”

董延明热泪盈眶，毕竟有了自己的定位了。他买回了雪糕，吴博士马上就安排他写产品使用手册，把他一肚子的新公司见闻生生憋回去。

董延明进公司已经一年了，老实说除了写产品使用文档之外什么也没有做过，帮刘大隆写的那个东西不能算数，那毕竟是为他人做嫁衣裳。后来董延明在华为看到部门庞大的资料部，终于悟到了吴博士一定是想把他培养成优秀的文档人才，这才会让他花费那么多时间写文档然后又对写出来文档横挑鼻子竖挑眼，不过当时的董延明不知道吴博士的苦心每日陷在文牍中苦不堪言。

一天吴博士给董延明共享了一份文档，“董啊，你研究一下这个文档。”

董延明看了看是个交换机使用手册，他翻了翻，迷惘道：“老大，你让我搞这个？”

吴博士说：“你看看人家文档的那个格式，那个用词，那个排版……”吴博士说的很激动，几乎要击节叫好了。

董延明又翻了半天还是不得要领，心想这用词也太平庸了，连个成语也没有，前面重复的道理说了又说，这不车轱辘话么？算了，扔一边上不看了。

转过天来，龚明明也跟董延明也提到了华为的文档，不过不同的是，他提到的是设计文档。

“设计什么文档？”

董延明是没有听过设计文档这个概念的，不过桑军可听过，他做对日外包整日面对的就是日本人的设计文档。他解释说，“就是设计事项书……”

“两个饼子！中国就毁你头猪手里了，一个天天混日子，一个帮日本人富国强兵，凡事还要指望我们海关，我们关……”，龚明明还是不习惯说我们公司，总要把“我们关”挂在嘴上，“我们关现在开始了学华为，大力的学啊！！我们现在编程也是从文档写起，我看了华为的内部设计文档，老牛B了。那格式，那排版，那用词……”

董延明听着耳熟，不过他还是不明白什么是设计文档。桑军又给他解释说：“就是别人给你写好了怎么编怎么编，全都用日语写好了，你把日语换成编程符号就可以了。就好像if，人家就写上如果，你照着编就可以了……”

董延明似乎明白了，但是又产生了一个疑问，“写文档的人都写到那个程度了，直接写代码不更快，这不是脱裤子放屁嘛？”

龚明明敲敲桌子，“你俩懂个屁，那是要一步一步地体现编程者的智慧！要从市场调查做起，一步一步地一条一条的实现客户需求。你俩大学简直就没上软件工程课。那个文档是一个接着一个，最开始简单，后来详细，好像叫什么需求设计……不管了，差不多这么个名字，桑你接触的那个是最后一步，叫详细设计。我跟华为……”

董延明打断龚明明描述自己跟华为的关系，又很虔诚的问龚明明，“明哥，你他妈的写文档要多久，有那个功夫是不是代码早就写出来了？”

龚明明一时语塞，桑军又趁热打铁问：“我写程序能实现你要的功能就行了，最后给你用就行了，你管我怎么做的干鸡吧毛。哦，对了，那玩意是给自己看得哈，我写那个文档给我自己看，我这不是贱么？”

龚明明又再次语塞，脸憋的通红，就好像孔乙己一样喷着，“这个文档跟你们的文档不一样……我们程序员的事情跟二B说不清楚……”

07年，董延明在华为领导team按照流程开发，review文档出名的严格，最喜欢在别人文档上打注释，“一坨屎，请参照培训要求重写。”

07年，龚明明在北软做QA，天天盯着别人写文档的时间点，经常因为写文档的时间缩短了而建议PM延长阶段时间。

07年，桑军去了日本工作，身在瀑布式的开发流程中，再也想不起来自己当年对这种流程开发有过微词。