【翻译】https://www.toptal.com/freelance/why-design-documents-matter
设计文档需要考虑哪些方面
1、需要实现哪些功能
2、需要运行在什么样的环境,多快的运行
3、可能失败的场景,解决方案
4、安装以及首次执行需要做哪些事情
5、用户使用限制
原则上说,就是尽量细致,这样可以避免错误,和误解。而误解和错误的设计可能会导致代码的重写。
里程碑
根据提供的软件产品,制定一系列的里程碑。
里程碑可以保证项目向着完成的方向前进。
里程碑的周期间隔尽量相等。
模版
一、目标申明
二、功能描述
三、用户接口
四、里程碑
备注
设计文档并不是一次写成后,作为合约不再修改的。
应该是根据情况进行调整的,中间开发中遇到问题可以修改,并与客户达成一致。
过程中的修改,同样需要与客户达成一致,充分沟通。
一次成型的设计几乎是没有的。
在过程中,每周多次与客户进行沟通,汇报进度,澄清确认提供的就是客户需要的版本。
做到双方都明确三件事:
1、开发前面做了什么
2、开发正在做什么
3、开发将要做什么