復(fù)盤：服務(wù)于敏捷開發(fā)的項(xiàng)目文檔

復(fù)盤：服務(wù)于敏捷開發(fā)的項(xiàng)目文檔作者從項(xiàng)目實(shí)踐出發(fā)，對完成的項(xiàng)目文檔產(chǎn)品進(jìn)行了分析復(fù)盤，并從多個方面對關(guān)于項(xiàng)目文檔的相關(guān)概念和功能進(jìn)行了拆解，與大家分享。最近完成了一個敏捷開發(fā)團(tuán)隊(duì)使用的項(xiàng)目文檔的產(chǎn)品，來復(fù)盤一下。項(xiàng)目文檔是什么？項(xiàng)目文檔，一個管理項(xiàng)目中產(chǎn)生的文檔的在線文件管理軟件。項(xiàng)目是由需求產(chǎn)生來的，有了需求就方便進(jìn)行需求分析，業(yè)務(wù)對象設(shè)定，功能拆解等工作步驟，以來指導(dǎo)和記錄整個項(xiàng)目運(yùn)行的過程。為什么要有項(xiàng)目文檔？敏捷開發(fā)，強(qiáng)調(diào)的是開發(fā)過程是敏捷的，但是最終的結(jié)果和瀑布開發(fā)是一樣的——一套完整的產(chǎn)品。單從文檔上講，敏捷開發(fā)相對瀑布開發(fā)少了部分不必要的文檔，但是少不代表沒有。產(chǎn)品后期若需要迭代，若是沒有文檔記錄,就會再浪費(fèi)一定資源（時(shí)間、人力）去梳理業(yè)務(wù)、關(guān)鍵數(shù)據(jù)流等。瀑布開發(fā)會在前期搞定所有的產(chǎn)品原型、功能等相關(guān)文檔，而敏捷開發(fā)，可能只是在項(xiàng)目前期，建立重要功能的相關(guān)文檔，然后再在過程中不斷為這些文檔添磚加瓦。整個項(xiàng)目文檔三個作用：開始時(shí)做規(guī)劃，明確產(chǎn)品方向過程中做指導(dǎo)，記錄運(yùn)行過程收尾后做回顧，驗(yàn)證初始需求項(xiàng)目文檔和產(chǎn)品文檔的區(qū)別？產(chǎn)品文檔就像是一個賬簿，而項(xiàng)目文檔則是這個賬簿的原始憑證。敏捷開發(fā)不像瀑布式開發(fā)那樣，根據(jù)需求指導(dǎo)書確立，再制定開發(fā)手冊，然后再實(shí)際動手開發(fā)，瀑布開發(fā)里使用的文檔，更像是產(chǎn)品文檔——對整個產(chǎn)品的說明、介紹。而項(xiàng)目文檔的重點(diǎn)在于，對項(xiàng)目過程的記錄：前期的業(yè)務(wù)說明、過程中的調(diào)整方案、后期的功能規(guī)劃等等，是比較零散的。二者共同點(diǎn)：兩者都有對產(chǎn)品信息的描述，都有一定產(chǎn)品開發(fā)指導(dǎo)作用。項(xiàng)目文檔組成一個產(chǎn)品業(yè)務(wù)對象的組成，來源于實(shí)際的使用情景。項(xiàng)目文檔就是給項(xiàng)目成員使用的。項(xiàng)目成員包含的角色通常有：項(xiàng)目經(jīng)理、產(chǎn)品經(jīng)理、開發(fā)、測試、UI等。而這些角色中，最常使用文檔的，就是產(chǎn)品經(jīng)理和項(xiàng)目經(jīng)理了。產(chǎn)品經(jīng)理在進(jìn)行產(chǎn)品設(shè)計(jì)時(shí)，常用的文檔種類就會包含：需求分析、概要設(shè)計(jì)和詳細(xì)設(shè)計(jì)。項(xiàng)目文檔主體結(jié)構(gòu)：此項(xiàng)目文檔是應(yīng)用在敏捷開發(fā)中的，一次敏捷項(xiàng)目要是經(jīng)過多次迭代的話，可能會產(chǎn)生多個需求文檔、功能列表文檔、業(yè)務(wù)說明等，所以這些類別都是作為用戶新建文檔時(shí)的一種文件類型，為了防止還有其他說明，可以加上一個普通文本類別。文檔和敏捷看板結(jié)合項(xiàng)目文檔是作為產(chǎn)品開發(fā)的指導(dǎo)，而敏捷看板則是作為產(chǎn)品開發(fā)的過程監(jiān)控。想要把二者結(jié)合起來，就要把二者的核心聯(lián)系起來。之前文章介紹過，敏捷開發(fā)里團(tuán)隊(duì)看板的核心是工作項(xiàng)，而項(xiàng)目文檔中，個人認(rèn)為

需求列表、功能列表以及詳細(xì)設(shè)計(jì)這三個是最重要的部分，這三者是指導(dǎo)項(xiàng)目進(jìn)行的核心。一個需求提出來后，可能經(jīng)過分析，拆解為若干個功能，這些功能再組合為實(shí)際開發(fā)的工作項(xiàng)，最后由工作項(xiàng)來反饋此需求有無被滿足。有了這種數(shù)據(jù)流的反饋，項(xiàng)目經(jīng)理可通過團(tuán)隊(duì)看板監(jiān)管項(xiàng)目進(jìn)展，而產(chǎn)品經(jīng)理可以通過項(xiàng)目文檔來跟蹤產(chǎn)品進(jìn)度。文檔功能擴(kuò)展項(xiàng)目文檔的使用角色，是整個項(xiàng)目團(tuán)隊(duì)成員，所以協(xié)同編輯就是一項(xiàng)非常重要的功能。實(shí)時(shí)的協(xié)同編輯，借助websocket或訂閱機(jī)制都可做到。整個項(xiàng)目文檔管理器，雖然像一個微型文件管理系統(tǒng)，不過還是希望，一個項(xiàng)目的所有文檔看起來像是一整個文檔一樣。就像開頭說的一樣，過程是零散的，結(jié)果是整體的。想要實(shí)現(xiàn)這點(diǎn)，可以參照word,左側(cè)的是文檔導(dǎo)航，右側(cè)的是文檔細(xì)則內(nèi)容。上面解決了，產(chǎn)品的規(guī)劃，過程的記錄，但是最終作為一個完整的產(chǎn)品文檔，項(xiàng)目文檔此時(shí)就不太合適?？梢酝ㄟ^項(xiàng)目文檔來生成一份產(chǎn)品文檔，或者抓取里面的局部數(shù)據(jù)生成一份使用手冊，如此就能把一個項(xiàng)目的文檔從前到后串聯(lián)起來?？偨Y(jié)這個項(xiàng)目文檔產(chǎn)品，整體目標(biāo)是服務(wù)于敏捷開發(fā)的，但是作為普通文檔管理也是可以的。作為在線文檔管理，所有的文件類型都是要求在線編輯