9、敏捷软件开发：重视工作软件而非全面文档

敏捷软件开发：重视工作软件而非全面文档

1. 文档在软件项目中的作用

• 文档的目的 ：文档的主要目的是传递信息，但它并非唯一的信息传递方式。与面对面交流相比，文档传递信息的能力有限，因为它仅由文字组成，缺乏肢体语言、语音语调、眼神交流等辅助理解的线索，且读者难以当场询问澄清问题，容易误解作者意图。不过，文档的价值在于其持久性，可供任何人随时重读，文字内容始终不变。文档在项目中有两个突出用途：
  • 为面对面交流做准备，提供历史、技术或讨论话题等信息，让参与者能更高效地交流，交流时还可纠正误解。
  • 记录面对面交流的结果，弥补人际交流的不足，便于参与者事后回顾，确保理解和记忆准确，也可作为企业记忆，减少未来的争议。
• 文档的受众 ：明确文档的受众至关重要，因为不同受众的知识、经验、阅读时间和信息使用方式不同，这会影响文档的内容、结构和呈现方式。例如，技术报告的执行摘要对忙碌的高管和技术人员有不同作用，高管可从中获取关键信息，技术人员则能借此了解文档整体内容和结论。只有明确受众及其信息需求，作者才能确保文档达到预期目的。
• 文档价值与成本 ：敏捷开发并非完全摒弃文档，而是避免在文档制作上浪费时间和精力。当文档出现以下情况时，就可能造成浪费：
  • 目的不明确；
  • 受众不清晰；
  • 针对目的和受众过度或不足设计；
  • 超出其有用寿命仍在维护。
    以需求规格说明书为例，其目的和