作者從項目實踐出發,對完成的項目文檔產品進行了分析復盤,並從多個方面對關於項目文檔的相關概念和功能進行了拆解,與大家分享。
最近完成了一個敏捷開發團隊使用的項目文檔的產品,來復盤一下。
項目文檔是什麼?
項目文檔,一個管理項目中產生的文檔的在線文件管理軟體。
項目是由需求產生來的,有了需求就方便進行需求分析,業務對象設定,功能拆解等工作步驟,以來指導和記錄整個項目運行的過程。
為什麼要有項目文檔?
敏捷開發,強調的是開發過程是敏捷的,但是最終的結果和瀑布開發是一樣的——一套完整的產品。單從文檔上講,敏捷開發相對瀑布開發少了部分不必要的文檔,但是少不代表沒有。
產品後期若需要迭代,若是沒有文檔記錄,就會再浪費一定資源(時間、人力)去梳理業務、關鍵數據流等。
瀑布開發會在前期搞定所有的產品原型、功能等相關文檔,而敏捷開發,可能只是在項目前期,建立重要功能的相關文檔,然後再在過程中不斷為這些文檔添磚加瓦。
整個項目文檔三個作用:
開始時做規劃,明確產品方向過程中做指導,記錄運行過程收尾後做回顧,驗證初始需求
項目文檔和產品文檔的區別?
產品文檔就像是一個帳簿,而項目文檔則是這個帳簿的原始憑證。
敏捷開發不像瀑布式開發那樣,根據需求指導書確立,再制定開發手冊,然後再實際動手開發,瀑布開發裡使用的文檔,更像是產品文檔——對整個產品的說明、介紹。
而項目文檔的重點在於,對項目過程的記錄:前期的業務說明、過程中的調整方案、後期的功能規劃等等,是比較零散的。
二者共同點:兩者都有對產品信息的描述,都有一定產品開發指導作用。
項目文檔組成
一個產品業務對象的組成,來源於實際的使用情景。
項目文檔就是給項目成員使用的。項目成員包含的角色通常有:項目經理、產品經理、開發、測試、UI等。而這些角色中,最常使用文檔的,就是產品經理和項目經理了。
產品經理在進行產品設計時,常用的文檔種類就會包含:需求分析、概要設計和詳細設計。
項目文檔主體結構:
此項目文檔是應用在敏捷開發中的,一次敏捷項目要是經過多次迭代的話,可能會產生多個需求文檔、功能列表文檔、業務說明等,所以這些類別都是作為用戶新建文檔時的一種文件類型,為了防止還有其他說明,可以加上一個普通文本類別。
文檔和敏捷看板結合
項目文檔是作為產品開發的指導,而敏捷看板則是作為產品開發的過程監控。想要把二者結合起來,就要把二者的核心聯繫起來。
之前文章介紹過,敏捷開發裡團隊看板的核心是工作項,而項目文檔中,個人認為需求列表、功能列表以及詳細設計這三個是最重要的部分,這三者是指導項目進行的核心。
一個需求提出來後,可能經過分析,拆解為若干個功能,這些功能再組合為實際開發的工作項,最後由工作項來反饋此需求有無被滿足。
有了這種數據流的反饋,項目經理可通過團隊看板監管項目進展,而產品經理可以通過項目文檔來跟蹤產品進度。
文檔功能擴展
項目文檔的使用角色,是整個項目團隊成員,所以協同編輯就是一項非常重要的功能。實時的協同編輯,藉助websocket或訂閱機制都可做到。
整個項目文檔管理器,雖然像一個微型文件管理系統,不過還是希望,一個項目的所有文檔看起來像是一整個文檔一樣。就像開頭說的一樣,過程是零散的,結果是整體的。想要實現這點,可以參照word,左側的是文檔導航,右側的是文檔細則內容。
上面解決了,產品的規劃,過程的記錄,但是最終作為一個完整的產品文檔,項目文檔此時就不太合適。可以通過項目文檔來生成一份產品文檔,或者抓取裡面的局部數據生成一份使用手冊,如此就能把一個項目的文檔從前到後串聯起來。
總結
這個項目文檔產品,整體目標是服務于敏捷開發的,但是作為普通文檔管理也是可以的。
作為在線文檔管理,所有的文件類型都是要求在線編輯的,例如在線的word、在線的流程圖設計器。文檔在線化後,一個好處就是便於整體搜索。
當然,這僅是個工具,想要用好工具,首先有對應的知識能力,以及良好的使用習慣。
本文由 @29號同學 原創發布於人人都是產品經理,未經作者許可,禁止轉載。
題圖來自Unsplash,基於CC0協議。