概念设计文档 / Design Document / 技术设计文档
软件设计文档
软件工程中用于在编码前明确技术方案、记录决策过程与权衡取舍的核心文档，帮助团队对齐认知、暴露假设并降低沟通成本
时间轴 (近 90 天)
9月14日
设计文档的最大收益往往发生在被评审之前，写作行为本身是一次思维的压力测试
待验证50%
9月14日
好的设计文档应明确要解决的问题，包含现状痛点、影响范围以及不解决的后果
待验证50%
9月14日
设计文档应列出考虑过的备选方案并解释最终选择理由，以展现决策过程
待验证50%
9月14日
设计文档应诚实写出方案在性能、复杂度、可维护性、上线风险等方面的取舍
待验证50%
9月14日
文档篇幅越长，被真正评审的概率越低，应控制篇幅并把细节放进附录或链接
待验证50%
9月14日
过时的文档比没有文档更危险，因为它会误导后来者
待验证50%
9月14日
在快速迭代的小团队中，维护重型设计文档的成本可能高于收益，更倾向于用代码、注释和轻量 RFC 替代
待验证50%
9月14日
文档的形式和详尽程度应当与团队规模、项目风险相匹配，而非一刀切
待验证50%
全部知识事实 (8)
待验证
设计文档的最大收益往往发生在被评审之前，写作行为本身是一次思维的压力测试
50%待验证好的设计文档应明确要解决的问题，包含现状痛点、影响范围以及不解决的后果
50%待验证设计文档应列出考虑过的备选方案并解释最终选择理由，以展现决策过程
50%待验证设计文档应诚实写出方案在性能、复杂度、可维护性、上线风险等方面的取舍
50%待验证文档篇幅越长，被真正评审的概率越低，应控制篇幅并把细节放进附录或链接
50%待验证过时的文档比没有文档更危险，因为它会误导后来者
50%待验证在快速迭代的小团队中，维护重型设计文档的成本可能高于收益，更倾向于用代码、注释和轻量 RFC 替代
50%待验证文档的形式和详尽程度应当与团队规模、项目风险相匹配，而非一刀切
50%