我感觉这个应该不是吐槽的问题，而是开源本身的定义问题。

现在大多数开源项目其实只是开源协议+代码部分开源，好一些的开源项目带 Issue 光速处理的。但是开源项目本身不是一个产品化或标准化的流程，写设计文档这件事就相当于招标投标那些流程然后开发时候做的穿插的一件事情了。如果将设计文档写好，那么开发者完全可以将这个当做一份完整的产品售卖，不开源的效益会更好。

而且设计文档本身可能写起来比代码更费力，就好比大学毕业设计写一个系统，自己写的代码是什么样心里很清楚也许没那么复杂，但就是难以在短时间内写出优美的设计方案来。

举一个简单的例子：编写一个 Web 框架，有一个路由解析函数，代码层面也许就是几个方法组合起来带过，自己心里很清楚，但是转换成详细设计文档，你就需要用额外的精力去画这个解析过程的流程图、思维导图、数据结构相关的表等，而有这些时间，我相信开发者更乐意先把 TODO 搞完。虽然一边写代码一边画流程也不是不行，但是代码可能好改，流程图也必须跟着反映变化，而这时你的思路就必须以设计文档为准了，这里你写的可能不是项目，更像是软件工程。

我觉得改善这种设计文档缺失的局面有几种解决办法：

- 首先就是让自己的项目变得成为类似标准一样的东西，自然有人会请求读源代码、看看“教科书”式的项目是怎么样炼成的。
- 其次就是不要单人开发，最好有一个不超过 5 人的小开发团队，提前对项目做好规划，但是团队内每个人都要非常清楚自己在做的事（人数少就是为了防止有人浑水摸鱼啥也不知道）。
- 开源项目模块化，尽量将自己的一个超大型项目拆分成可独立的小项目，比如会话模块、路由模块、连接保持模块等。
- 如果是小项目，可以在写 README 时，让 README 本身不仅做简介，还做一下对程序工作流程的简介（这个很重要，有时虽然可能缺失文档，但是非常有助于包括自己在内的他人可以更方便地读源代码）。