編輯導(dǎo)讀：寫產(chǎn)品需求是產(chǎn)品經(jīng)理最常做的工作之一，它考驗(yàn)的是一個(gè)產(chǎn)品經(jīng)理的基本功，因?yàn)楫a(chǎn)品需求文檔算得上是產(chǎn)品經(jīng)理的半個(gè)大腦。如何書寫一份可讀性高的需求文檔呢？本文作者從自身工作經(jīng)驗(yàn)出發(fā)，總結(jié)了六點(diǎn)細(xì)節(jié)，與你分享。

“不專業(yè)的產(chǎn)品經(jīng)理，你連ta需求文檔都讀不下去”，這是近期很有共鳴的一句話，產(chǎn)品需求文檔算得上是產(chǎn)品經(jīng)理的半個(gè)大腦，因?yàn)楫a(chǎn)品需求文檔是前期所有工作的結(jié)果，那一份可讀性高的需求文檔到底有哪些共性？

首先先了解我們大腦是怎么理解文字或一段話的，我們遇到事情需要去理解時(shí)就會(huì)將得到的信息往已知的模型上靠，一旦如果我們大腦有類似模型，理解起來就很容易。如果沒找到類似的模型，理解就很困難。

一、聲明名詞，幫助閱讀者建立已知模型

為什么提到Toast大家知道是提示對(duì)話框，因?yàn)門oast已經(jīng)被多次教育大腦已經(jīng)“定義”好了，大腦能直接解析并獲得信息。但如果需求文檔中經(jīng)常出現(xiàn)的或者陌生的詞，就可以在文檔開頭定義清楚，這樣一來就能讓閱讀者清晰明白，這個(gè)常出現(xiàn)或者陌生的詞到底是什么意思。有點(diǎn)類似于紙質(zhì)書里面的注釋，避免理解誤差，達(dá)成共識(shí)。

二、用開發(fā)熟悉的語言來寫文檔

網(wǎng)上經(jīng)常會(huì)有人問，開發(fā)喜歡看怎樣的需求文檔，用戶開發(fā)熟悉的語言來寫，即一些邏輯描述和開發(fā)平時(shí)常接觸描述一致，如開頭所提到，往開發(fā)已知的信息模型上靠，比如一個(gè)列表的排序規(guī)則，我們想描述時(shí)間越近排在越前的時(shí)候，通常會(huì)這么寫“XXX按動(dòng)態(tài)更新時(shí)間從大到小排序”，最好的應(yīng)該這么描述是“按更新時(shí)間倒序”，“倒序/升序/降序”應(yīng)該已經(jīng)存在每個(gè)開發(fā)人員的已知信息模型中，理解起來更容易。

除了排序外比較常見的還有時(shí)間單位，可以用yyyy-MM-dd hh:MM:ss即年月日時(shí)分秒來代替，相比文字描述研發(fā)對(duì)字母代碼更熟悉。

三、結(jié)構(gòu)化圖文搭配

如果一個(gè)頁面需求比較復(fù)雜且是純文字描述性的文字，一大坨一大坨堆在一起別說開發(fā)人員，就算是你接手了離職同事的文檔，相信你也看不不下去，能用圖來描述的情況下就不要用文字，圖+文字搭配可讀性會(huì)更高，一圖勝千言，因?yàn)閷?shí)際開發(fā)時(shí)，開發(fā)需要考慮后續(xù)邏輯變化，如果只有純描述性的文字，開發(fā)可能還得猜后續(xù)邏輯變化，但如果有流程圖/泳道圖搭配文字描述，那結(jié)果就完全不一樣了。

四、善用表格

如果一個(gè)需求涉及“一對(duì)多”或者“多對(duì)多”的時(shí)候，比如根據(jù)“不同用戶等級(jí)給予不同的文案提示”，用表格把“等級(jí)和對(duì)應(yīng)提示文案”裝起來，真的會(huì)有一目十行的效果。我們得感謝有“表格”這種東西存在，因?yàn)槿绻麤]有表格，我們可能得多喝5L水和開發(fā)面對(duì)面溝通，估計(jì)后續(xù)還得在微信上敲5000個(gè)字。

五、巧用公式

公式是最常見的邏輯處理之一，涉及到一些加減乘除的計(jì)算邏輯，盡可能公式化來描述需求，這樣能簡(jiǎn)化開發(fā)的理解和思考。比如我們?cè)诿枋龇e分變化情況時(shí)，通常喜歡用純描述性的文字來寫文檔，“點(diǎn)擊簽到按鈕用戶積分加1，點(diǎn)擊抽獎(jiǎng)按鈕用戶積分-20”

如果把純描述性文字轉(zhuǎn)換成公式化變成以下這樣：

• “點(diǎn)擊簽到按鈕 用戶積分 = 總積分 + 1”
• “點(diǎn)擊兌換按鈕 用戶積分 = 總積分 – 20 ”

是不是更加直觀更符合開發(fā)語言。

但是記得不要“得寸進(jìn)尺”，如果覺得自己一定開發(fā)基礎(chǔ)，還想進(jìn)一步提高開發(fā)人員閱讀效率，是不是可以寫成“偽代碼”直接給開發(fā)照貓畫虎。個(gè)人不建議這么做，因?yàn)椴煌_發(fā)語言寫法都不一樣，你理解的語言在開發(fā)角度可能不容易理解，我以前就犯過一個(gè)錯(cuò)誤，web端的彈窗alert，在Android端得用AlertDialog安卓開發(fā)才容易理解，不然還得理解你這個(gè)alert才能轉(zhuǎn)化自己的思路，并且需求文檔閱讀人員里面還包含了測(cè)試人員，就算開發(fā)理解了，測(cè)試不一定會(huì)理解。

一些能被復(fù)用的產(chǎn)品模塊，盡可能保持同樣的寫法，如果描述的畫風(fēng)不一樣，開發(fā)有可能給你做出不一樣的東西，當(dāng)然上面所提到的內(nèi)容，均建立在邏輯沒有硬傷的前提下。

六、持續(xù)進(jìn)步

可以去看一下部分框架和平臺(tái)的開發(fā)文檔，比如web端常見的Ant Design，Element，如果產(chǎn)品形態(tài)是小程序可以去看微信小程序開發(fā)文檔等等， 這樣能夠了解框架/平臺(tái)的更新日志，這種信息了解的越多，對(duì)技術(shù)理解越深入，這樣不管是寫文檔還是和開發(fā)溝通都會(huì)有很大幫助，同時(shí)這也是洞察力的一種表現(xiàn)。因?yàn)椴糠中履芰ΩＭ悄銇硖嵝验_發(fā)，這樣開發(fā)更有積極性來響應(yīng)，而不是平臺(tái)更新了某個(gè)功能你毫不知情，反過來開發(fā)來提醒你，就顯得非常被動(dòng)。

切勿硬生生套用模板！

經(jīng)常會(huì)有一些讀者加微信后會(huì)問“園長(zhǎng)，你有PRD模板嗎”，模板只是面上的東西，對(duì)于新人來說，模板只能給自己提供一個(gè)思路，而不是全部套用，畢竟合適自己的才是最好的，所以最好的模板內(nèi)容模塊應(yīng)該是內(nèi)部多次實(shí)操后總結(jié)出來的。

#專欄作家#

動(dòng)物園園長(zhǎng)，微信公眾號(hào)：首席吹牛官，個(gè)人網(wǎng)站：http://chiefbragger.com/，人人都是產(chǎn)品經(jīng)理專欄作家?；ヂ?lián)網(wǎng)圈十八線作詞人，國家一級(jí)退堂鼓表演藝術(shù)家。顏良而文丑，歡迎交流。

本文原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可，禁止轉(zhuǎn)載

題圖來自Unsplash，基于CC0協(xié)議