六問禅道6:還需不需要寫文檔?
我自己从2010年8月开始接触和使用禅道項目管理软件,由刚开始的只使用测试--Bug管理模块,到现在的所有模块均有在使用。
在不斷的使用過程中,加上長期混迹在禅道QQ技術交流群,對禅道的使用,項目管理也有了深入的理解。
在QQ群裏,同樣的問題經常被問起,看起來是個小問題,其實裏面卻蘊含了項目管理的一些大道理。
因此,我以禅道使用爲背景,再加上自己的拙見,整理了“六問禅道”系列禅道使用分享,希望能達到抛磚引玉的效果。
歡迎吐槽指正。
有不少童鞋覺得,我們采用了敏捷開發,也借助禅道做項目管理,這文檔應該就不用寫了吧。
打著敏捷開發的幌子,覺得文檔完全沒必要寫了。拿到需求,就開始埋頭coding。
敏捷項目管理,我們還需不需要寫文檔?
我的答案是:
要寫文檔,要重視文檔的作用。
接口、數據庫、架構文檔,涉及到與其他團隊溝通的文檔是非常有必要寫的。
文檔在項目管理中起著重要的作用:
- 掌握項目的具體進度,了解項目的預期工作目標。
- 産品的开发有时会拆分成多个项目,由不同的项目组去开发。文档有助于各项目组的沟通协作,提供一个工作交流的凭证。
- 給後期運維工作提供必要的依據。
- 有利于團隊知識積累,爲新項目提供參考價值。
文檔的書寫和管理注意事項:
- 做好文檔分類。 把産品文档和项目文档分类管理,然后再産品和项目文档里再细分管理,捋清文档的归属。
- 統一文檔的命名。規範文檔的命名,這樣方便管理和查找。比如說禅道的需求文檔可以寫成:zentao_story_9.9,表示作者是禅道9.9版本的需求文檔。
- 做好文檔版本的維護。爲了應對項目開發過程中的需求變更和其他因素引起的變更,可以把文檔的版本做區分,一來是做一個記錄,二來也方便開發人員查看。
- 可以的話,統一文檔模板 。模板統一,文檔的脈絡清晰,方便查閱。
文檔是對禅道流程提供了一個很好的輔助和補充功能。
禅道新版本細化和加強了文檔功能。

