软件工程|如何写设计文档

这是极客时间《许式伟的结构课》中的 <70|怎样写设计文档> 的笔记

产品经理和架构师是一体两面，对人的能力要求比较像，但是分工不同，关注的维度不一样
产品经理关注的维度，关键词是：用户需求、技术赋能、商业成功
架构师的关注维度是，关键词是：用户需求、技术实现、业务迭代

设计是软件工程中的头等大事，我们应该在这里“多浪费点时间”，这样的 ”浪费“ 是最终会得到十倍甚至百倍以上的回报

1. 文档的大体内容

设计文档包含的内容，大体如下

• 现状：我们在哪里，现状是什么样的
• 需求：我们的问题或诉求是什么，要如何改进
• 需求满足方式：
  • 要做成什么样，交付物规格，使用界面（接口）是什么
  • 怎么做到？交付物的实现原理

1.1 现状

现状不需要长篇累牍，现状更的多是陈述与我们要做的改变相关的重要事实，侧重于强调这些事实的存在性和重要性。

1.2 需求

需求也不需要长篇累牍，陈述对痛点和改进方法即可

1.3 需求满足方式

要详细写清楚，把我们的设计方案谈清楚。具体包含交付物规格和实现原理