敏捷开发与文档：互补还是互斥？

敏捷宣言背景与误解

2001年，17位软件开发者共同发布了《敏捷宣言》，提出个人和交互、工作软件、客户协作和响应变化的重要性。尽管宣言强调左侧原则的优先级，业界仍存在对敏捷开发方法的误解，将“高于”误读为“取代”，从而导致了完全忽略文档的错误做法。

敏捷神话解析：文档的真正地位

敏捷开发并不排斥文档，而是诉求文档的恰到好处。过多的文档会造成时间浪费，信息过时，而文档不足则会妨碍沟通和知识共享。敏捷团队应在需要时智能地创建必要文档。

专注于敏捷文档的原因

敏捷文档的创建和维护虽然看似繁琐，但它对于利益相关者的需求、与外部团队的沟通、交付支持和梳理有效信息都至关重要。团队应在业务决策下，平衡文档工作与开发工作。

敏捷中编写文档的原则与时机

敏捷文档应遵循“刚刚好”原则，及时创作，并易于团队获取和协作。文档应在迭代交付工作软件后，或者根据项目需要持续更新。有效的敏捷文档策略需要权衡文档的及时性与持续性。

敏捷文档的内容与结论

敏捷文档可能包括产品愿景、项目概述、设计决策、操作和支持文档等。文档应简洁、准确和有用，用户文档需要易懂，以最小化用户培训需求。最终，敏捷开发方法鼓励在确保足够价值的前提下，保持文档的简单性和适用性。

如何从CMMI迈向DevOps国标？

了解更多

敏捷开发

查看原文：敏捷开发与文档：互补还是互斥？

文章来源：

敏捷开发

扫码关注公众号