寫(xiě)文檔是一個(gè)產(chǎn)品經(jīng)理的必備技能。產(chǎn)品經(jīng)理需要將寫(xiě)的文檔交給上司，交給開(kāi)發(fā)，交給設(shè)計(jì)。但往往產(chǎn)品經(jīng)理們殫精竭慮寫(xiě)出長(zhǎng)篇累牘的文檔，在開(kāi)發(fā)那里只是瞅幾眼就扔到一旁了。其實(shí)這也不能怪開(kāi)發(fā)，因?yàn)橐话阍谛枨笤u(píng)審的時(shí)候，開(kāi)發(fā)已經(jīng)將產(chǎn)品的整個(gè)邏輯了解的差不多了。如果開(kāi)發(fā)過(guò)程中有什么問(wèn)題，直接和產(chǎn)品溝通的效率也要比一頁(yè)頁(yè)的翻看文檔有用多了。這個(gè)時(shí)候產(chǎn)品經(jīng)理就會(huì)很郁悶，我已經(jīng)在文檔里寫(xiě)的清清楚楚 ，為什么還要來(lái)問(wèn)我？這個(gè)時(shí)候，寫(xiě)出一份開(kāi)發(fā)喜歡不煩人的文檔就皆大歡喜啦~

    我覺(jué)得，作為一份開(kāi)發(fā)喜歡的文檔，應(yīng)該具備以下幾個(gè)特點(diǎn)：

　　1. 盡量精簡(jiǎn)文字，少些套話(huà)，將需求和邏輯寫(xiě)清楚即可；

　　2. 可以將復(fù)雜的需求可以進(jìn)行拆分。單條邏輯不要過(guò)于復(fù)雜；

　　3. 多配合原型圖將抽象的邏輯轉(zhuǎn)化為具象的可進(jìn)行操作的行為路徑；

　　4. 邏輯環(huán)要封閉，不能出現(xiàn)開(kāi)發(fā)寫(xiě)著寫(xiě)著寫(xiě)不下去的情況。

　　一、盡量精簡(jiǎn)文字，少些套話(huà)，將需求和邏輯寫(xiě)清楚即可

　　一些剛開(kāi)始寫(xiě)文檔的產(chǎn)品經(jīng)理，為了標(biāo)榜自己的專(zhuān)業(yè)性，將給開(kāi)發(fā)看的文檔寫(xiě)的特別多。一個(gè)小小的迭代某個(gè)功能的項(xiàng)目就可能寫(xiě)幾十頁(yè)，然而里面有一大部分的內(nèi)容都是一些數(shù)據(jù)分析，商業(yè)市場(chǎng)分析或者是用戶(hù)行為的一些敘述。并不是說(shuō)這些東西不能寫(xiě)，因?yàn)橐粋€(gè)完整的需求文檔是必然包括這些部分的。但是對(duì)于一份要交給開(kāi)發(fā)的文檔來(lái)說(shuō)，他們接到文檔后看了好長(zhǎng)時(shí)間發(fā)現(xiàn)和自己一點(diǎn)關(guān)系都沒(méi)有，就很難有再繼續(xù)看下去的耐心了。

　　另外，在關(guān)于邏輯部分，盡量使用通俗易懂簡(jiǎn)潔的語(yǔ)言去敘述。有時(shí)候產(chǎn)品經(jīng)理在寫(xiě)文檔的時(shí)候?yàn)榱梭w現(xiàn)自己的專(zhuān)業(yè)性以及嚴(yán)謹(jǐn)性，許多的話(huà)寫(xiě)的特別官方、拗口，或者比較啰嗦。比如下面是從網(wǎng)上找到的需求文檔中的一段話(huà)：

　　“系統(tǒng)自動(dòng)分配：系統(tǒng)跟進(jìn)客戶(hù)申請(qǐng)的地址，自動(dòng)分配數(shù)據(jù)，優(yōu)先按縣級(jí)分配、若無(wú)匹配的縣級(jí)服務(wù)機(jī)構(gòu)，則按市級(jí)服務(wù)機(jī)構(gòu)分配，若無(wú)市級(jí)機(jī)構(gòu)，則按省級(jí)服務(wù)機(jī)構(gòu)分配，若無(wú)省級(jí)機(jī)構(gòu)，則進(jìn)入手動(dòng)分配，由風(fēng)控管理人員手動(dòng)分配信息”

　　其實(shí)這段話(huà)描述的邏輯是比較簡(jiǎn)單的，我認(rèn)為完全沒(méi)有必要將一個(gè)重復(fù)的邏輯都寫(xiě)出來(lái)。這段話(huà)可以縮減成“系統(tǒng)根據(jù)用戶(hù)申請(qǐng)的地址，自動(dòng)匹配到縣級(jí)服務(wù)機(jī)構(gòu)，若沒(méi)有該級(jí)機(jī)構(gòu)就向上匹配“市級(jí)，省級(jí)”。如果都沒(méi)有就由風(fēng)控管理人手動(dòng)分配信息”

　　如果我是開(kāi)發(fā)人員，我可能就會(huì)更加傾向于后面這種，即便語(yǔ)言看起來(lái)并不是特別官方，但是文字較少同時(shí)邏輯也明了的文檔。

　　二、可以將復(fù)雜的需求可以進(jìn)行拆分。單條邏輯不要過(guò)于復(fù)雜

　　產(chǎn)品經(jīng)理在接手一個(gè)比較大的項(xiàng)目的時(shí)候，功能和邏輯可能都會(huì)比較復(fù)雜。這個(gè)時(shí)候，文檔里面的流程圖以及思維導(dǎo)圖就會(huì)比較長(zhǎng)，比較復(fù)雜。其實(shí)這個(gè)時(shí)候，產(chǎn)品經(jīng)理無(wú)論是在寫(xiě)邏輯敘述還是畫(huà)流程圖的時(shí)候，都可以將一個(gè)大的流程拆分成幾個(gè)小的流程。這樣交付給開(kāi)發(fā)的話(huà)，單個(gè)邏輯較為簡(jiǎn)單開(kāi)發(fā)也有看下去的耐心。那么，如何將一個(gè)復(fù)雜的流程拆分成簡(jiǎn)單的流程，我認(rèn)為有以下幾點(diǎn)：

　　1、在有判斷邏輯的時(shí)候，盡量不要拆分，有跳轉(zhuǎn)邏輯的時(shí)候，可以根據(jù)它的一個(gè)相關(guān)性進(jìn)行拆分。

　　比如，在下面的這個(gè)流程圖中，我可以將進(jìn)入初審之前作為一個(gè)流程；進(jìn)入授信之前作為一個(gè)流程，其余的作為一個(gè)流程。分為三個(gè)部分分別寫(xiě)邏輯，一個(gè)是可以降低開(kāi)發(fā)的心理壓力，另外單個(gè)模塊開(kāi)發(fā)流程的描述也會(huì)顯得個(gè)更加簡(jiǎn)潔。但是，這樣寫(xiě)的話(huà)如果后面的版塊會(huì)涉及到前面版塊的邏輯一定要寫(xiě)清楚，以免開(kāi)發(fā)在開(kāi)發(fā)后面版塊的時(shí)候再去改動(dòng)前面的邏輯。

　2、閉環(huán)邏輯、雙向邏輯也可以進(jìn)行拆分。

　可以想象，如果開(kāi)發(fā)看到這樣的邏輯圖后會(huì)有什么樣的反應(yīng)。這是給人看的嗎？算了，還是去問(wèn)產(chǎn)品吧。如果我們仔細(xì)梳理一下這個(gè)邏輯圖，發(fā)現(xiàn)它其實(shí)并不是特別的復(fù)雜。比如到封禁用戶(hù)這一塊，與其它的雙向邏輯只有封禁解禁的功能，單項(xiàng)操作只有加入黑名單這樣的一個(gè)。我們就可以把它單獨(dú)拎出來(lái)，作為一個(gè)流程。

在我們?nèi)サ袅藘H僅是封禁用戶(hù)這一個(gè)角度及相關(guān)邏輯后，回頭再來(lái)看這個(gè)邏輯圖，就已經(jīng)簡(jiǎn)化了很多了，同時(shí)單獨(dú)拎出來(lái)的這個(gè)邏輯圖也比較簡(jiǎn)單。目的性較強(qiáng)，開(kāi)發(fā)在寫(xiě)的時(shí)候并沒(méi)有太大邏輯上的困惑。

　　三、多配合原型圖將抽象的邏輯轉(zhuǎn)化為具象的可進(jìn)行操作的行為路徑

　　在我們描述某個(gè)功能邏輯的時(shí)候，單純文字上的敘述并不是十分的具象。這個(gè)時(shí)候如果我們已經(jīng)將原型圖畫(huà)好了，那么完全可以在原型上將其標(biāo)注出來(lái)，這個(gè)時(shí)候并不是指要畫(huà)出交互線(xiàn)框圖，而是我可以將邏輯寫(xiě)到我的原型上面。

　　比如可以在原型上面可以操作的區(qū)域標(biāo)上①②③，然后在下面寫(xiě)清楚它的一個(gè)邏輯。這樣的話(huà)，不僅可以將整體的邏輯拆分為一個(gè)個(gè)的單獨(dú)邏輯，同時(shí)圖像傳遞信息的這種方式也要比單純的文字讓人覺(jué)得更有看下去的欲望。

　　四、功能邏輯要把每一種情況都考慮到，不能出現(xiàn)開(kāi)發(fā)寫(xiě)著寫(xiě)著寫(xiě)不下去的情況

　　關(guān)于最后一種情況，其實(shí)并不是為了讓開(kāi)發(fā)有興趣讀下去。而是出于自身所寫(xiě)文檔的一個(gè)嚴(yán)謹(jǐn)性。由于產(chǎn)品經(jīng)理在接觸到某一項(xiàng)的業(yè)務(wù)的時(shí)候，首先考慮到的情況是大場(chǎng)景下面以及比較順暢的業(yè)務(wù)流程，所以這個(gè)時(shí)候很多地方的邏輯就會(huì)被忽略掉，當(dāng)開(kāi)發(fā)寫(xiě)到這一塊的邏輯時(shí)，才發(fā)現(xiàn)之前寫(xiě)的東西到這一塊已經(jīng)進(jìn)行不下去了，這個(gè)時(shí)候不僅開(kāi)發(fā)周期延誤，做了許多無(wú)用功，而且之前所寫(xiě)的文檔沒(méi)準(zhǔn)也需要進(jìn)行大的改動(dòng)。所以在寫(xiě)文檔之前，不要怕麻煩，首先要通過(guò)思維導(dǎo)圖軟件，將每一種情況都寫(xiě)出來(lái)，即所謂的窮舉。然后通過(guò)其每種情況再寫(xiě)邏輯，這樣的話(huà)可以盡量的避免以上情況的發(fā)生。

　　上面的分析只是我自己的一些看法，可能有些公司對(duì)于需求文檔這方面有著自己嚴(yán)格的格式和定義，所以這一套并不是特別的適用。但是如果是我們自己寫(xiě)文檔的話(huà)，通過(guò)一些技巧將溝通成本降到最低，減小一些自己和開(kāi)發(fā)的工作，豈不是皆大歡喜。

來(lái)源：人人都是產(chǎn)品經(jīng)理