活文档

• 传统文档：更新不及时，写起来费时费力。
  • 最讨厌的两件事：写文档，别人不写文档
• 活文档：能使文档内容永远保存最新，成本低，并能让文档变得有趣
  • 四原则：
    • 可靠：无论何时，活文档都是准确的，并且与所交付的软件保持同步。
      • 利用可用的知识：大多数知识已经存在于项目的文件中。为了编写文档，我们要做的只是提取、扩充和整理。
      • 准确性机制：制定一个准确性机制，以确保知识与项目始终保持同步。
    • 省力：活文档最大限度地减少了文档工作量，即使是软件发生了变更。它仅需要极少的额外工作，而且只需要操作一次。
    • 协作：活文档可以促进所有参与者之间的对话和知识共享。
    • 有见地：活文档会将人们的注意力引导到工作的各个方面，从而提供反馈机会并鼓励深度思考。它能帮助你反思正在进行的工作并作出更好的决策。
• 和 领域驱动设计 的关系：优先代码体现模型，只有当代码不足以传递知识时，才求助于其他东西。