六问禅道6：还需不需要写文档？

我自己从2010年8月开始接触和使用 禅道项目管理软件，由刚开始的只使用测试--Bug管理模块，到现在的所有模块均有在使用。

在不断的使用过程中，加上长期混迹在禅道QQ技术交流群，对禅道的使用，项目管理也有了深入的理解。

在QQ群里，同样的问题经常被问起，看起来是个小问题，其实里面却蕴含了项目管理的一些大道理。

因此，我以禅道使用为背景，再加上自己的拙见，整理了“六问禅道”系列禅道使用分享，希望能达到抛砖引玉的效果。

欢迎吐槽指正。

有不少童鞋觉得，我们采用了敏捷开发，也借助禅道做项目管理，这文档应该就不用写了吧。

打着敏捷开发的幌子，觉得文档完全没必要写了。拿到需求，就开始埋头coding。

敏捷项目管理，我们还需不需要写文档？

我的答案是：

要写文档，要重视文档的作用。

接口、数据库、架构文档，涉及到与其他团队沟通的文档是非常有必要写的。

文档在项目管理中起着重要的作用：

• 掌握项目的具体进度，了解项目的预期工作目标。
• 产品的开发有时会拆分成多个项目，由不同的项目组去开发。文档有助于各项目组的沟通协作，提供一个工作交流的凭证。
• 给后期运维工作提供必要的依据。
• 有利于团队知识积累，为新项目提供参考价值。

文档的书写和管理注意事项：

• 做好文档分类。 把产品文档和项目文档分类管理，然后再产品和项目文档里再细分管理，捋清文档的归属。
• 统一文档的命名。规范文档的命名，这样方便管理和查找。比如说禅道的需求文档可以写成：zentao_story_9.9，表示作者是禅道9.9版本的需求文档。
• 做好文档版本的维护。为了应对项目开发过程中的需求变更和其他因素引起的变更，可以把文档的版本做区分，一来是做一个记录，二来也方便开发人员查看。
• 可以的话，统一文档模板 。模板统一，文档的脉络清晰，方便查阅。

文档是对禅道流程提供了一个很好的辅助和补充功能。

禅道新版本细化和加强了文档功能。