你讨厌写设计文档，但它却是必须的

设计文档设计说明书| 2016-02-06

大部分的程序员都是白痴，而余下的那部分都是狗屎。有时候我会觉得自己两者都属于，所以我敢信心十足的这么说。

狗屎

狗屎们在读设计说明书时会用一把密密的梳子仔细梳理里面的内容，查找里面的漏洞、疏忽、或简单的拼写错误。当开发程序时，他们会严格的按照说明书的需求规范——尽管是有问题的。当有人冲着他们叫喊说软件有问题时，他们会得意洋洋的指着说明书里的某些语句，这些语句清楚的表明这严重有问题的软件在技术上是完全没问题的，然后这个事件就会被他们放到博客里吹嘘一番。

在狗屎们里有一小撮人是写测试用例的。在写说明书的编写过程中这些人一般会留守，因为在说明书最终定版之前随时都会把他们抽过来投入无尽的查补漏洞的工作中。但不幸的是，狗屎们要比你想象的难对付的多，需要你花更多的时间。这就是为什么好设计说明书需要花这么长时间编写的原因：大部分的时间都消耗在了应付这些狗屎们的工作中。

白痴

白痴们，却是另外一种情况，他们从来不看设计说明书，直到有人冲着他们大喊大叫。他的做法通常是，先不知道是从哪而弄到了一些demo，然后按照这有限的demo开发出程序，差不多能用。自然，等这个产品发布后，他们不可避免的被人大呼小叫一番，因为有人碰巧用到了产品里的这部分功能，跟说明书里描述的这部分完全不一致。有人会指着说明书里的这些语句，这些语句表明了他们的程序里有多么严重的问题，于是白痴们才修改这些问题。

除了常见的白痴外，这还有两类特殊的白痴，值得提一下。前一种是做demo、打包程序，之后就像其他白痴一样被人叫骂的。但当他们被叫骂着要求去读一读设计说明书时，他们会神奇的转变成狗屎型，他们会嚷嚷着设计书含糊不清，有歧义，或者是可忽略不计——因为没有人会这样实现它或它本身是错的。这些人可以被称为激进分子。他们永远写不出符合要求的程序——不管设计书写的如何详细，这部分人可以被放心的忽略不计。

另外一种一小撮的白痴是写demo、打包程序，然后被人叫骂的。但当他们被要求去读一读设计书时，他们会神奇的变成唱赞歌的人，他们会把从这些错误中学得的经验写成指导性文章。这些人于是被人称作专家。事实上，世界上所有的教材指导都是由“白痴变成的专家”写成的。