產(chǎn)品新人如何寫出不被研發(fā)懟的需求文檔
產(chǎn)品經(jīng)理這崗位都多少年了,我還以為早就體系成熟、流程閉環(huán)了,所以這個系列我也安心停更了。
結(jié)果最近被研發(fā)同事輪番吐槽:需求文檔東漏一句西漏一段,“這也叫專業(yè)?”
雖然不是在點名罵我,但誰讓是我?guī)У年犇?,臉還是要我來紅……
于是我,一個曾立志不再寫基礎(chǔ)規(guī)范的人,現(xiàn)在又默默打開了“手把手教你系列”的草稿頁。~~
老規(guī)矩,事先聲明:本文是寫給產(chǎn)品新人的一個指導(dǎo)方向,別指望面面俱到,主要是幫你少挨點罵、少被群嘲。如果你是產(chǎn)品大牛,那我更希望你能站出來寫一篇“不被研發(fā)吐槽的終極需求文檔指南”,拜托了,真心在線等
一、產(chǎn)品需求文檔的意義
不講假大空,就講人話。
對于產(chǎn)品新人來說,產(chǎn)品需求文檔的核心意義只有兩個詞:“明確” 和 “可做”。
1. 什么叫“明確”?
就是別寫那些虛頭巴腦的虛詞、副詞,需求文檔里應(yīng)該盡量只出現(xiàn)三種詞:名詞、動詞、量詞。1)先說“虛詞”
虛詞就是介詞、連詞、助詞、嘆詞這些——這些詞基本是語文老師教你寫作文用的,但在需求文檔里,誰用誰挨打。
比如錯誤的寫法:
點擊“登錄”按鈕,需要進行用戶名和密碼校驗吧。
請注意那個“吧”。它是個助詞,但在研發(fā)眼里,它是個雷區(qū),說出來就是自找“被懟”。你在寫需求時用“吧”來表達不確定性,那研發(fā)就會用“呵呵”來反饋你的不專業(yè)。
再說“副詞”
副詞看著高級,實則沒用。它是修飾動詞、形容詞等的,比如:
錯誤示范:
校驗成功后,要迅速地進入工作臺頁面。
請問“迅速地”是多快?光靠感情無法落地。正確寫法是:
校驗成功后,500ms內(nèi)進入工作臺頁面。
給出量化標準,才叫明確。不然你以為你是寫詩的?
2. 什么叫“可做”?
就是這玩意真的能做出來。
別寫那些感天動地但做不到的需求。比如早些年討論的很激烈的一個需求:
手機殼顏色要能根據(jù)用戶心情變化。
聽起來是不是很酷?是。但你們公司八成沒這個技術(shù)。
甚至你們連怎么判斷“用戶今天心情好不好”都不知道——那你讓研發(fā)怎么做?
再比如下面這個需求,看似合理,實則扯淡:
密碼校驗成功后,需要1ms內(nèi)進入工作臺頁面。
拜托,1ms?你以為你寫的是芯片設(shè)計規(guī)范嗎?這違背客觀規(guī)律,純屬“想當(dāng)然”。
二、需求文檔有沒有固定格式?
答案是:沒有。
不同公司、不同團隊、不同Leader的口味都不一樣。你可能在A公司畫個5頁原型圖就叫文檔,去了B公司沒畫10張流程圖都不敢說寫完了。
但常見的結(jié)構(gòu)大致是這些:
- 版本記錄
- 需求背景
- 產(chǎn)品架構(gòu)圖/功能信息圖/流程圖
- 功能清單
- 功能性需求詳細說明
- 數(shù)據(jù)埋點
- 非功能性需求,如比如性能、安全性、兼容性等等
- 等到其他內(nèi)容,如上線準備清單、測試數(shù)據(jù)等到
是不是聽著有點多?別慌。
對于產(chǎn)品新人,我的建議是:別想著全寫全會,一開始只抓關(guān)鍵的三塊就夠了:
1. 版本記錄
這玩意不是裝樣子,是為了防止后面撕逼。寫清楚哪個版本改了什么,誰提的需求,什么時候調(diào)整了內(nèi)容——未來回頭看時能對上口徑。偶爾有時候研發(fā)為了證明自己動了腦子,說了很多高要求的話,然后要他敲代碼實現(xiàn)的時候,就會舔著你的臉讓你重新改下~~
2. 需求背景
說清楚“為什么要做這個需求”,不要“因為老板說要做”就直接寫功能了。產(chǎn)品是為了解決問題,不是為了解決老板。也為了讓研發(fā)能更好的思考代碼怎么敲的更順暢~~
3. 功能性需求詳細說明
這是文檔的靈魂部分,研發(fā)90%的關(guān)注點都在這。
要清晰、要量化、要能落地——怎么觸發(fā)、觸發(fā)后發(fā)生什么、邊界條件是啥、有無異常流程……
把這三塊寫清楚了,你就已經(jīng)比一半新人強了。
后面那些流程圖、埋點、性能要求等等,等你入門之后再慢慢加,沒人一口氣寫出《PRD完全體》。但寫不清背景、邏輯混亂、沒有版本記錄——這些坑,新人最容易踩。
這
三、產(chǎn)品文檔的撰寫邏輯
其實寫法也沒固定套路,可以按功能流程來寫,比如“用戶從A操作走到B”,也可以按頁面邏輯來寫,一個頁面一個模塊往下拆。
我個人更推薦按頁面邏輯寫。為什么?因為這種方式更“防漏”。你每打開一個頁面,就能順著頁面里有哪些按鈕、入口、彈窗去列功能,漏點的概率比按流程走低很多。不過你的流程圖之類的得說清楚,不然研發(fā)可能看的有點頭疼。
舉個栗子:登錄頁面
一、版本記錄
略
二、需求背景
略
三、功能流程圖
略
四、功能需求描述
1、登錄頁
1.1 顯示系統(tǒng)名稱及說明:XXX管理系統(tǒng),東半球最具影響力的系統(tǒng)
1.2 登錄方式選擇
1.2.1 賬號密碼登錄
略
1.2.2 手機號登錄(默認選中)
1.2.2.1 手機號-文本輸入框
a. 弱提示:手機號
b. 輸入規(guī)則:必填,必須輸入11位數(shù)字,超出后不支持輸入。
c. 校驗規(guī)則:首位只能為1且為11位數(shù)字。
d. 報錯提示:
1)為空時提醒:請輸入手機號
2)手機號不符合校驗規(guī)則提示:請輸入正確的11位手機號
1.2.2.2 驗證碼-文本輸入框
a. 弱提示:驗證碼
b. 輸入規(guī)則:必填,最初支持輸入6位數(shù)字,超出后不支持輸入。
c. 校驗規(guī)則:6位數(shù)字。
d. 報錯提示:
1)為空時提醒:請輸入驗證碼
2)驗證碼不符合校驗規(guī)則提醒:請輸入正確的6位數(shù)驗證碼
1.2.2.3 獲取驗證碼-按鈕
a. 狀態(tài)1:未點擊狀態(tài),默認狀態(tài)
1)顯示文字:獲取驗證碼
2)操作:支持點擊之后校驗手機號是否為注冊用戶,不支持連續(xù)點擊:
2.1)不是則提示“賬號不存在,請注冊后再嘗試”。
2.2)是注冊用戶,則切換【狀態(tài)2:60秒倒計時】狀態(tài)
2.2.1)發(fā)送驗證碼短信。短信內(nèi)容為:您的驗證碼為:XXXXXX,驗證碼有效期為5分鐘
2.2.2)如果短信發(fā)送成功,則彈出氣泡提示:驗證碼發(fā)送成功
2.2.3)如果短信發(fā)送識別,則彈出氣泡提示:驗證碼發(fā)送失敗,請稍后再試。 狀態(tài)切換為【狀態(tài)1:未點擊狀態(tài)】
b. 狀態(tài)2:60秒倒計時
1)顯示文字:XX秒,60秒倒計時
2)操作:不可點擊
3) 倒計時結(jié)束后,切換為【狀態(tài)3:重新獲取驗證碼】
c. 狀態(tài)3:重新獲取驗證碼
1)顯示文字:重新獲取驗證碼
2)操作:支持點擊,不支持連續(xù)點擊,點擊之后效果與【1.2.2.3 獲取驗證碼-按鈕】一致??蓞⒖荚摬糠謨?nèi)容。
1.2.3 自動登錄-單選框
1.2.3.1 狀態(tài)1:未選中狀態(tài)(默認狀態(tài))
操作:支持點擊,點擊切換狀態(tài)
1.2.3.2)狀態(tài)2:已選中狀態(tài)
操作:支持點擊,點擊切換狀態(tài)
1.2.4 忘記密碼-按鈕
操作:點擊進入找回密碼頁面。
1.2.5 登錄-按鈕
1.2.5.1 點擊,校驗以下內(nèi)容:
a 手機號是否為空、是否符合校驗規(guī)則,不符合則提示:請輸入正確的11位手機號
b 驗證碼是否為空、是否符合校驗規(guī)則,不符合則提示:請輸入正確的6位數(shù)驗證碼
c 校驗手機號與驗證碼是否匹配、驗證碼是否過期,不符合則提示:驗證碼錯誤,請重新輸入
d 以上校驗全部通過,則彈出氣泡提示”登錄成功”,并進入工作臺頁面。
e 異常報錯提示:
1)如果無法正常通信,則提示”網(wǎng)絡(luò)錯誤,請檢查網(wǎng)絡(luò)后重新嘗試”。
2)其他錯誤,則提示”登錄失敗,請聯(lián)系管理員,錯誤代碼1001″
1.2.6 注冊賬號-按鈕,點擊,進入注冊頁面。
1.2.7 幫助-按鈕,點擊進入幫助頁面。
1.2.8 隱私-按鈕,點擊進入隱私頁面。
1.2.9 條款-按鈕,點擊進入條款頁面。
以上這些,就是一份需求文檔在具體填寫時的基本要求。如果你認真按這個思路寫,研發(fā)大概能知道該做什么,測試也能明確哪些地方該測、哪些邊界要重點關(guān)注。
但別太樂觀地以為寫完就一勞永逸了。
現(xiàn)實是這樣的:
你寫完后覺得很清楚
- 研發(fā)一看:“這個跳轉(zhuǎn)在哪實現(xiàn)?”
- 測試一看:“這個異常狀態(tài)沒寫???”
所以記住一句話:需求文檔是“動態(tài)更新”的,不是寫完就丟進知識庫的PPT。
在開發(fā)過程中,有遺漏很正常,但不能“遺漏了就不補”。誰補?當(dāng)然是你補。
及時修訂文檔,更新版本記錄,標注修改時間和內(nèi)容 —— 這才是一個專業(yè)產(chǎn)品的基本功。
因為到了測試階段,沒人有空翻你10天前的口述群聊記錄,只有文檔說了算。
相關(guān)閱讀
思路|產(chǎn)品新人應(yīng)如何進行數(shù)據(jù)分析
思路|產(chǎn)品新人應(yīng)如何撰寫測試用例(功能性測試)
作者:光點神奇,微信公眾號:產(chǎn)品研究所
本文由 @光點神奇 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)作者許可,禁止轉(zhuǎn)載
題圖由作者提供
該文觀點僅代表作者本人,人人都是產(chǎn)品經(jīng)理平臺僅提供信息存儲空間服務(wù)
- 目前還沒評論,等你發(fā)揮!