復盤：服務于敏捷開發(fā)的項目文檔

復盤：服務于敏捷開發(fā)的項目文檔作者從項目實踐出發(fā)，對完成的項目文檔產(chǎn)品進行了分析復盤，并從多個方面對關于項目文檔的相關概念和功能進行了拆解，與大家分享。最近完成了一個敏捷開發(fā)團隊使用的項目文檔的產(chǎn)品，來復盤一下。項目文檔是什么？項目文檔，一個管理項目中產(chǎn)生的文檔的在線文件管理軟件。項目是由需求產(chǎn)生來的，有了需求就方便進行需求分析，業(yè)務對象設定，功能拆解等工作步驟，以來指導和記錄整個項目運行的過程。為什么要有項目文檔？敏捷開發(fā)，強調(diào)的是開發(fā)過程是敏捷的，但是最終的結(jié)果和瀑布開發(fā)是—樣的——一套完整的產(chǎn)品。單從文檔上講，敏捷開發(fā)相對瀑布開發(fā)少了部分不必要的文檔，但是少不代表沒有。產(chǎn)品后期若需要迭代，若是沒有文檔記錄就會再浪費一定資源（時間、人力）去梳理業(yè)務、關鍵數(shù)據(jù)流等。瀑布開發(fā)會在前期搞定所有的產(chǎn)品原型、功能等相關文檔/而敏捷開發(fā)，可能只是在項目前期，建立重要功能的相關文檔，然后再在過程中不斷為這些文檔添磚加瓦。整個項目文檔三個作用：開始時做規(guī)劃，明確產(chǎn)品方向過程中做指導，記錄運行過程收尾后做回顧，驗證初始需求產(chǎn)品文檔就像是一個賬簿，而項目文檔則是這個賬簿的原始憑證。敏捷開發(fā)不像瀑布式開發(fā)那樣，根據(jù)需求指導書確立，再制定開發(fā)手冊，然后再實際動手開發(fā)，瀑布開發(fā)里使用的文檔，更像是產(chǎn)品文檔一對整個產(chǎn)品的說明、介紹。而項目文檔的重點在于，對項目過程的記錄：前期的業(yè)務說明、過程中的調(diào)整方案、后期的功能規(guī)劃等等，是比較零散的。二者共同點:兩者都有對產(chǎn)品信息的描述，都有一定產(chǎn)品開發(fā)指導作用。項目文檔組成—個產(chǎn)品業(yè)務對象的組成，來源于實際的使用情景。項目文檔就是給項目成員使用的。項目成員包含的角色通常有：項目經(jīng)理、產(chǎn)品經(jīng)理、開發(fā)、測試、UI等。而這些角色中，最常使用文檔的，就是產(chǎn)品經(jīng)理和項目經(jīng)理了。產(chǎn)品經(jīng)理在進行產(chǎn)品設計時，常用的文檔種類就會包含：需求分析、概要設計和詳細設計。項目文檔主體結(jié)構(gòu):實慵婁罔業(yè)務眶刮 ?切刪表 ?加進 實慵婁罔業(yè)務眶刮 ?切刪表 ?加進 ?祝限說明 @ 此項目文檔是應用在敏捷開發(fā)中的，一次敏捷項目要是經(jīng)過多次迭代的話，可能會產(chǎn)生多個需求文檔、功能列表文檔、業(yè)務說明等，所以這些類別都是作為用戶新建文檔時的一種文件類型，為了防止還有其他說明，可以加上一個普通文本類別。▼匚畫求清單三畫求列表主題存產(chǎn)慨長設計?業(yè)務擁?文i二主昔這喧腦圖復制至X二明書流程移動至三功能尋匚Word存..詳細設計需求列恚屈昔通文本旳童列表文檔和敏捷看板結(jié)合項目文檔是作為產(chǎn)品開發(fā)的指導，而敏捷看板則是作為產(chǎn)品開發(fā)的過程監(jiān)控。想要把二者結(jié)合起來，就要把二者的核心聯(lián)系起來。之前文章介紹過，敏捷開發(fā)里團隊看板的核心是工作項，而項目文檔中，個人認為需求列表、功能列表以及詳細設計這三個是最重要的部分，這三者是指導項目進行的核心。需求「工作項數(shù)據(jù)流季疥一曲蚤.這是個"分情況r苑一人看愛良逹訐人豈言雰?nèi)粜羌緦帒蹁娋蛪斡犡M擊汨,瑋勺改託基本屋一討一?需求1:N功能I力丟一工乍項?懇是亍」合“言E莊多個功卑士丈一八開我二吒匚券功能N:1工作項

項目文檔的使用角色，是整個項目團隊成員，所以協(xié)同編輯就是一項非常重要的功能。實時的協(xié)同編輯，借助websocket或訂閱機制都可做到。整個項目文檔管理器，雖然像一個微型文件管理系統(tǒng)，不過還是希望，—個項目的所有文檔看起來像是一整個文檔一樣。就像開頭說的一樣，過程是零散的，結(jié)果是整體的。想要實現(xiàn)這點，可以參照word,左側(cè)的是文檔導航，右側(cè)的是文檔細則內(nèi)容。日錄 ￡5 ■■—'*<抵三安計■■■■嘆態(tài)明交桂升竜沖削*<抵三安計■■■■嘆態(tài)明交桂升竜沖削E虧前tf杏凌比站n志記錄￡墓曰右■點莊桎劑*W不一□'乍項芝回收站陸H.土導岀項目姑闔日古-?IN5-HTblKe-..0pTvFeF_ - |1 _￡e-TrHn刊內(nèi)密TD[lEFi2N3uhjBG味程醫(yī)王h三豈Iuug*. 土-.. ,心心&■■HZ3件吐翠記盤略葉勻就用戶.UJJSSfe■= .-：克砰且岀歷中滬撫 開在時爲“ —訶一iu.垃就T打開時間亞 乏刊護 1映:些打王蜒否存亡吃 啟刪至：血；務瑚品 ■■”譴尊土3= TSJ套制節(jié)原流程圉0 顯示主宴曇r■對和：的s$j：斗甘■■□0 顯示需求「丁件項數(shù)據(jù)流SSIrHj能.1￡是亍甘堆況”HJ—？《翅健時功囲若是；S捋桶彌劃的闕”腳Ki能E一對一*靜1:N功刪jfi卜工托項，速是亍"臺1S泯.越*■攻僥合為Yff笈工忙任務功能M或龍盍砂:J：忙臣焙變憂對.tL:r -^-C1純列專持^妙才:1-功能點有對應的前點.期暉字點越也司—Eb.P'心*」■ 還汽屹點所芨丐応士戀，損！.污昱忒主衣I；:1過應：'功啦點左?？弋於耳!=-.<KQ一、上面解決了，產(chǎn)品的規(guī)劃，過程的記錄，但是最終作為一個完整的產(chǎn)品文檔，項目文檔此時就不太合適?？梢酝ㄟ^項目文檔來生成一份產(chǎn)品文檔，或者抓取里面的局部數(shù)據(jù)生成一份使用手冊，如此就能把一個項目的文檔從前到后串聯(lián)起來?？偨Y(jié)這個項目文檔產(chǎn)品，整體目標是服務于敏捷開發(fā)的，但是作為普通文檔管