[工程设计] 软件开发的设计文档

【翻译】https://www.toptal.com/freelance/why-design-documents-matter

设计文档需要考虑哪些方面

1、需要实现哪些功能

2、需要运行在什么样的环境，多快的运行

3、可能失败的场景，解决方案

4、安装以及首次执行需要做哪些事情

5、用户使用限制

原则上说，就是尽量细致，这样可以避免错误，和误解。而误解和错误的设计可能会导致代码的重写。

里程碑

根据提供的软件产品，制定一系列的里程碑。

里程碑可以保证项目向着完成的方向前进。

里程碑的周期间隔尽量相等。

模版

一、目标申明

二、功能描述

三、用户接口

四、里程碑

备注

设计文档并不是一次写成后，作为合约不再修改的。

应该是根据情况进行调整的，中间开发中遇到问题可以修改，并与客户达成一致。

过程中的修改，同样需要与客户达成一致，充分沟通。

一次成型的设计几乎是没有的。

在过程中，每周多次与客户进行沟通，汇报进度，澄清确认提供的就是客户需要的版本。

做到双方都明确三件事：

1、开发前面做了什么

2、开发正在做什么

3、开发将要做什么