作者從項目實踐出發(fā)，對完成的項目文檔產(chǎn)品進(jìn)行了分析復(fù)盤，并從多個方面對關(guān)于項目文檔的相關(guān)概念和功能進(jìn)行了拆解，與大家分享。

最近完成了一個敏捷開發(fā)團(tuán)隊使用的項目文檔的產(chǎn)品，來復(fù)盤一下。

項目文檔是什么？

項目文檔，一個管理項目中產(chǎn)生的文檔的在線文件管理軟件。

項目是由需求產(chǎn)生來的，有了需求就方便進(jìn)行需求分析，業(yè)務(wù)對象設(shè)定，功能拆解等工作步驟，以來指導(dǎo)和記錄整個項目運(yùn)行的過程。

為什么要有項目文檔？

敏捷開發(fā)，強(qiáng)調(diào)的是開發(fā)過程是敏捷的，但是最終的結(jié)果和瀑布開發(fā)是一樣的——一套完整的產(chǎn)品。單從文檔上講，敏捷開發(fā)相對瀑布開發(fā)少了部分不必要的文檔，但是少不代表沒有。

產(chǎn)品后期若需要迭代，若是沒有文檔記錄,就會再浪費(fèi)一定資源（時間、人力）去梳理業(yè)務(wù)、關(guān)鍵數(shù)據(jù)流等。

瀑布開發(fā)會在前期搞定所有的產(chǎn)品原型、功能等相關(guān)文檔，而敏捷開發(fā)，可能只是在項目前期，建立重要功能的相關(guān)文檔，然后再在過程中不斷為這些文檔添磚加瓦。

整個項目文檔三個作用：

1. 開始時做規(guī)劃，明確產(chǎn)品方向
2. 過程中做指導(dǎo)，記錄運(yùn)行過程
3. 收尾后做回顧，驗證初始需求

項目文檔和產(chǎn)品文檔的區(qū)別？

產(chǎn)品文檔就像是一個賬簿，而項目文檔則是這個賬簿的原始憑證。

敏捷開發(fā)不像瀑布式開發(fā)那樣，根據(jù)需求指導(dǎo)書確立，再制定開發(fā)手冊，然后再實際動手開發(fā)，瀑布開發(fā)里使用的文檔，更像是產(chǎn)品文檔——對整個產(chǎn)品的說明、介紹。

而項目文檔的重點(diǎn)在于，對項目過程的記錄：前期的業(yè)務(wù)說明、過程中的調(diào)整方案、后期的功能規(guī)劃等等，是比較零散的。

二者共同點(diǎn)：兩者都有對產(chǎn)品信息的描述，都有一定產(chǎn)品開發(fā)指導(dǎo)作用。

項目文檔組成

一個產(chǎn)品業(yè)務(wù)對象的組成，來源于實際的使用情景。

項目文檔就是給項目成員使用的。項目成員包含的角色通常有：項目經(jīng)理、產(chǎn)品經(jīng)理、開發(fā)、測試、UI等。而這些角色中，最常使用文檔的，就是產(chǎn)品經(jīng)理和項目經(jīng)理了。

產(chǎn)品經(jīng)理在進(jìn)行產(chǎn)品設(shè)計時，常用的文檔種類就會包含：需求分析、概要設(shè)計和詳細(xì)設(shè)計。

項目文檔主體結(jié)構(gòu)：

此項目文檔是應(yīng)用在敏捷開發(fā)中的，一次敏捷項目要是經(jīng)過多次迭代的話，可能會產(chǎn)生多個需求文檔、功能列表文檔、業(yè)務(wù)說明等，所以這些類別都是作為用戶新建文檔時的一種文件類型，為了防止還有其他說明，可以加上一個普通文本類別。

文檔和敏捷看板結(jié)合

項目文檔是作為產(chǎn)品開發(fā)的指導(dǎo)，而敏捷看板則是作為產(chǎn)品開發(fā)的過程監(jiān)控。想要把二者結(jié)合起來，就要把二者的核心聯(lián)系起來。

之前文章介紹過，敏捷開發(fā)里團(tuán)隊看板的核心是工作項，而項目文檔中，個人認(rèn)為?需求列表、功能列表以及詳細(xì)設(shè)計這三個是最重要的部分，這三者是指導(dǎo)項目進(jìn)行的核心。

一個需求提出來后，可能經(jīng)過分析，拆解為若干個功能，這些功能再組合為實際開發(fā)的工作項，最后由工作項來反饋此需求有無被滿足。

有了這種數(shù)據(jù)流的反饋，項目經(jīng)理可通過團(tuán)隊看板監(jiān)管項目進(jìn)展，而產(chǎn)品經(jīng)理可以通過項目文檔來跟蹤產(chǎn)品進(jìn)度。

文檔功能擴(kuò)展

項目文檔的使用角色，是整個項目團(tuán)隊成員，所以協(xié)同編輯就是一項非常重要的功能。實時的協(xié)同編輯，借助websocket或訂閱機(jī)制都可做到。

整個項目文檔管理器，雖然像一個微型文件管理系統(tǒng)，不過還是希望，一個項目的所有文檔看起來像是一整個文檔一樣。就像開頭說的一樣，過程是零散的，結(jié)果是整體的。想要實現(xiàn)這點(diǎn)，可以參照word,左側(cè)的是文檔導(dǎo)航，右側(cè)的是文檔細(xì)則內(nèi)容。

上面解決了，產(chǎn)品的規(guī)劃，過程的記錄，但是最終作為一個完整的產(chǎn)品文檔，項目文檔此時就不太合適?？梢酝ㄟ^項目文檔來生成一份產(chǎn)品文檔，或者抓取里面的局部數(shù)據(jù)生成一份使用手冊，如此就能把一個項目的文檔從前到后串聯(lián)起來。

總結(jié)

這個項目文檔產(chǎn)品，整體目標(biāo)是服務(wù)于敏捷開發(fā)的，但是作為普通文檔管理也是可以的。

作為在線文檔管理，所有的文件類型都是要求在線編輯的，例如在線的word、在線的流程圖設(shè)計器。文檔在線化后，一個好處就是便于整體搜索。

當(dāng)然，這僅是個工具，想要用好工具，首先有對應(yīng)的知識能力，以及良好的使用習(xí)慣。

本文由 @29號同學(xué) 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理，未經(jīng)作者許可，禁止轉(zhuǎn)載。

題圖來自Unsplash，基于CC0協(xié)議。