13、软件开发文档与工作产物全解析

软件开发文档与工作产物全解析

1. 文档需求的决策

在软件开发过程中，究竟需要哪些文档一直是个备受关注的问题。答案是由项目发起人和团队共同决定，主要基于以下四点原因：
- 系统不断变化 ：系统在功能和设计上始终处于变化之中，投入大量时间、精力和资源进行设计文档编写，会影响系统交付进度，而且文档往往会滞后于实际情况，导致不准确。
- 设计追溯需求 ：设计师需要留下一些记录，以便数月后能唤起自己的记忆，也能帮助其他设计师理解他们的工作。
- 项目情况差异 ：软件开发的具体情况因项目而异，只有发起人和团队能根据实际情况，权衡进度需求和信息线索需求，找到最佳的文档记录方式。
- 技术持续更新 ：不同的技术对应不同的文档形式，如数据库系统、大型机系统、科学系统、面向对象系统和实时系统等，都有各自合适的文档格式，且技术变化频繁，所以无法统一规定。

2. 文档时间维度与策略

软件开发项目在文档方面有两个时间维度的考量：
- 软件编写阶段 ：此阶段应尽量减少文档编写时间，以加快软件交付，可视为“贪婪行动”，旨在实现近期交付系统的主要目标。
- 软件交接阶段 ：将软件移交给其他团队时，丰富的文档则至关重要，可看作“投资行动”，为后续项目做准备。

这两个阶段的需求相互冲突，团队在文档处理上往往需要进行权衡。理想情况下，团队应尽可能晚地、快速且低成本地生成存档文档，但“不做文档”并非可行的选择，