如何写好设计文档？
本文基于Go官方proposal仓库中的五个优秀设计文档，提炼其共性结构与写作方法，形成一份可复用的设计文档写作指南。Go设计文档以朴素语言讨论重要取舍，让陌生读者快速理解问题、方案及原因。总结出的通用模板包括元信息、摘要概述、背景动机、设计提案、理由取舍、兼容性、实现过渡计划和附录等部分。关键点包括：标题用一句话说清做什么；摘要埋下最重要承诺；背景动机用具体代码示例说明痛点，让读者‘疼’起来；设计提案采用渐进式教学，配Go声明和代码示例，明确边界；理由取舍主动对比备选方案，解释‘为什么不是别的’；兼容性诚实承认代价，提供渐进迁移路径；实现计划用数据和工具支撑可落地性；附录后置完整API和FAQ。文章强调设计文档应注重可读性、实用性和长期价值，适用于软件工程师和技术负责人参考。