產(chǎn)品新人如何寫出不被研發(fā)懟的需求文檔

0 評論 2648 瀏覽 10 收藏 13 分鐘

產(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ù)

更多精彩內(nèi)容,請關(guān)注人人都是產(chǎn)品經(jīng)理微信公眾號或下載App
評論
評論請登錄
  1. 目前還沒評論,等你發(fā)揮!