復(fù)盤(pán):服務(wù)于敏捷開(kāi)發(fā)的項(xiàng)目文檔
作者從項(xiàng)目實(shí)踐出發(fā),對(duì)完成的項(xiàng)目文檔產(chǎn)品進(jìn)行了分析復(fù)盤(pán),并從多個(gè)方面對(duì)關(guān)于項(xiàng)目文檔的相關(guān)概念和功能進(jìn)行了拆解,與大家分享。
最近完成了一個(gè)敏捷開(kāi)發(fā)團(tuán)隊(duì)使用的項(xiàng)目文檔的產(chǎn)品,來(lái)復(fù)盤(pán)一下。
項(xiàng)目文檔是什么?
項(xiàng)目文檔,一個(gè)管理項(xiàng)目中產(chǎn)生的文檔的在線文件管理軟件。
項(xiàng)目是由需求產(chǎn)生來(lái)的,有了需求就方便進(jìn)行需求分析,業(yè)務(wù)對(duì)象設(shè)定,功能拆解等工作步驟,以來(lái)指導(dǎo)和記錄整個(gè)項(xiàng)目運(yùn)行的過(guò)程。
為什么要有項(xiàng)目文檔?
敏捷開(kāi)發(fā),強(qiáng)調(diào)的是開(kāi)發(fā)過(guò)程是敏捷的,但是最終的結(jié)果和瀑布開(kāi)發(fā)是一樣的——一套完整的產(chǎn)品。單從文檔上講,敏捷開(kāi)發(fā)相對(duì)瀑布開(kāi)發(fā)少了部分不必要的文檔,但是少不代表沒(méi)有。
產(chǎn)品后期若需要迭代,若是沒(méi)有文檔記錄,就會(huì)再浪費(fèi)一定資源(時(shí)間、人力)去梳理業(yè)務(wù)、關(guān)鍵數(shù)據(jù)流等。
瀑布開(kāi)發(fā)會(huì)在前期搞定所有的產(chǎn)品原型、功能等相關(guān)文檔,而敏捷開(kāi)發(fā),可能只是在項(xiàng)目前期,建立重要功能的相關(guān)文檔,然后再在過(guò)程中不斷為這些文檔添磚加瓦。
整個(gè)項(xiàng)目文檔三個(gè)作用:
- 開(kāi)始時(shí)做規(guī)劃,明確產(chǎn)品方向
- 過(guò)程中做指導(dǎo),記錄運(yùn)行過(guò)程
- 收尾后做回顧,驗(yàn)證初始需求
項(xiàng)目文檔和產(chǎn)品文檔的區(qū)別?
產(chǎn)品文檔就像是一個(gè)賬簿,而項(xiàng)目文檔則是這個(gè)賬簿的原始憑證。
敏捷開(kāi)發(fā)不像瀑布式開(kāi)發(fā)那樣,根據(jù)需求指導(dǎo)書(shū)確立,再制定開(kāi)發(fā)手冊(cè),然后再實(shí)際動(dòng)手開(kāi)發(fā),瀑布開(kāi)發(fā)里使用的文檔,更像是產(chǎn)品文檔——對(duì)整個(gè)產(chǎn)品的說(shuō)明、介紹。
而項(xiàng)目文檔的重點(diǎn)在于,對(duì)項(xiàng)目過(guò)程的記錄:前期的業(yè)務(wù)說(shuō)明、過(guò)程中的調(diào)整方案、后期的功能規(guī)劃等等,是比較零散的。
二者共同點(diǎn):兩者都有對(duì)產(chǎn)品信息的描述,都有一定產(chǎn)品開(kāi)發(fā)指導(dǎo)作用。
項(xiàng)目文檔組成
一個(gè)產(chǎn)品業(yè)務(wù)對(duì)象的組成,來(lái)源于實(shí)際的使用情景。
項(xiàng)目文檔就是給項(xiàng)目成員使用的。項(xiàng)目成員包含的角色通常有:項(xiàng)目經(jīng)理、產(chǎn)品經(jīng)理、開(kāi)發(fā)、測(cè)試、UI等。而這些角色中,最常使用文檔的,就是產(chǎn)品經(jīng)理和項(xiàng)目經(jīng)理了。
產(chǎn)品經(jīng)理在進(jìn)行產(chǎn)品設(shè)計(jì)時(shí),常用的文檔種類(lèi)就會(huì)包含:需求分析、概要設(shè)計(jì)和詳細(xì)設(shè)計(jì)。
項(xiàng)目文檔主體結(jié)構(gòu):
此項(xiàng)目文檔是應(yīng)用在敏捷開(kāi)發(fā)中的,一次敏捷項(xiàng)目要是經(jīng)過(guò)多次迭代的話(huà),可能會(huì)產(chǎn)生多個(gè)需求文檔、功能列表文檔、業(yè)務(wù)說(shuō)明等,所以這些類(lèi)別都是作為用戶(hù)新建文檔時(shí)的一種文件類(lèi)型,為了防止還有其他說(shuō)明,可以加上一個(gè)普通文本類(lèi)別。
文檔和敏捷看板結(jié)合
項(xiàng)目文檔是作為產(chǎn)品開(kāi)發(fā)的指導(dǎo),而敏捷看板則是作為產(chǎn)品開(kāi)發(fā)的過(guò)程監(jiān)控。想要把二者結(jié)合起來(lái),就要把二者的核心聯(lián)系起來(lái)。
之前文章介紹過(guò),敏捷開(kāi)發(fā)里團(tuán)隊(duì)看板的核心是工作項(xiàng),而項(xiàng)目文檔中,個(gè)人認(rèn)為?需求列表、功能列表以及詳細(xì)設(shè)計(jì)這三個(gè)是最重要的部分,這三者是指導(dǎo)項(xiàng)目進(jìn)行的核心。
一個(gè)需求提出來(lái)后,可能經(jīng)過(guò)分析,拆解為若干個(gè)功能,這些功能再組合為實(shí)際開(kāi)發(fā)的工作項(xiàng),最后由工作項(xiàng)來(lái)反饋此需求有無(wú)被滿(mǎn)足。
有了這種數(shù)據(jù)流的反饋,項(xiàng)目經(jīng)理可通過(guò)團(tuán)隊(duì)看板監(jiān)管項(xiàng)目進(jìn)展,而產(chǎn)品經(jīng)理可以通過(guò)項(xiàng)目文檔來(lái)跟蹤產(chǎn)品進(jìn)度。
文檔功能擴(kuò)展
項(xiàng)目文檔的使用角色,是整個(gè)項(xiàng)目團(tuán)隊(duì)成員,所以協(xié)同編輯就是一項(xiàng)非常重要的功能。實(shí)時(shí)的協(xié)同編輯,借助websocket或訂閱機(jī)制都可做到。
整個(gè)項(xiàng)目文檔管理器,雖然像一個(gè)微型文件管理系統(tǒng),不過(guò)還是希望,一個(gè)項(xiàng)目的所有文檔看起來(lái)像是一整個(gè)文檔一樣。就像開(kāi)頭說(shuō)的一樣,過(guò)程是零散的,結(jié)果是整體的。想要實(shí)現(xiàn)這點(diǎn),可以參照word,左側(cè)的是文檔導(dǎo)航,右側(cè)的是文檔細(xì)則內(nèi)容。
上面解決了,產(chǎn)品的規(guī)劃,過(guò)程的記錄,但是最終作為一個(gè)完整的產(chǎn)品文檔,項(xiàng)目文檔此時(shí)就不太合適。可以通過(guò)項(xiàng)目文檔來(lái)生成一份產(chǎn)品文檔,或者抓取里面的局部數(shù)據(jù)生成一份使用手冊(cè),如此就能把一個(gè)項(xiàng)目的文檔從前到后串聯(lián)起來(lái)。
總結(jié)
這個(gè)項(xiàng)目文檔產(chǎn)品,整體目標(biāo)是服務(wù)于敏捷開(kāi)發(fā)的,但是作為普通文檔管理也是可以的。
作為在線文檔管理,所有的文件類(lèi)型都是要求在線編輯的,例如在線的word、在線的流程圖設(shè)計(jì)器。文檔在線化后,一個(gè)好處就是便于整體搜索。
當(dāng)然,這僅是個(gè)工具,想要用好工具,首先有對(duì)應(yīng)的知識(shí)能力,以及良好的使用習(xí)慣。
本文由 @29號(hào)同學(xué) 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理,未經(jīng)作者許可,禁止轉(zhuǎn)載。
題圖來(lái)自Unsplash,基于CC0協(xié)議。
推薦工具:https://www.xiaopiu.com/
我之前用過(guò)了好多文檔工具,但始終沒(méi)發(fā)現(xiàn)合適的,使用過(guò)的包括 語(yǔ)雀、wps、office、石墨、有道云筆記、印象筆記、tapd、teambition 的thoughts、notion、熊掌記、為知筆記,飛書(shū)是最近一個(gè)打算用的,但始終沒(méi)發(fā)現(xiàn)理想款產(chǎn)品,從一開(kāi)始的office 流,到 notion 這類(lèi)集成式文檔的興起,最后還是嘗試了 icloud + 各種本地工具,因?yàn)楸镜毓ぞ吣壳霸诖怪眻?chǎng)景上還是相對(duì)強(qiáng)的,但缺點(diǎn)是 finder 的目錄管理不好用,之前也給自己整理了各種項(xiàng)目和文檔管理規(guī)范,但落地還是不太好,很希望能與你交流交流,我的郵箱是:manyhong@126.com
太棒了!我也想過(guò)做這個(gè),但是我做產(chǎn)品前是做的后端,前端很弱,可以給個(gè)試用賬號(hào)嗎,以及交流交流?
你這個(gè)啥軟件?
自己研發(fā)的敏捷開(kāi)發(fā)的項(xiàng)目文檔管理