編輯導(dǎo)語：對(duì)于產(chǎn)品經(jīng)理來說，制作一份滿意的需求文檔是必須要掌握的技能。然而在設(shè)計(jì)需求文檔的過程中，涉及到很多的小細(xì)節(jié)，稍不注意就很難取得滿意的效果。如此一來，就要學(xué)會(huì)對(duì)需求文檔進(jìn)行自檢，本文作者就為我們列出了一份清單。

我們公司之前是沒有專業(yè)的測(cè)試的，所以測(cè)試都是我自己上。

我們的系統(tǒng)主要是數(shù)據(jù)邏輯比較復(fù)雜，一般我自己在測(cè)試時(shí)，主要是在正向邏輯上進(jìn)行驗(yàn)證。最多是在數(shù)據(jù)邏輯上考慮閉合，再為下一次寫相似的需求時(shí)，把類似的數(shù)據(jù)漏洞進(jìn)行填補(bǔ)。

因此之前的測(cè)試中，很容易是自己寫的邏輯，自己發(fā)現(xiàn)邏輯漏洞，然后改掉。

現(xiàn)在我們具備了專業(yè)的測(cè)試團(tuán)隊(duì)之后，發(fā)現(xiàn)專業(yè)的測(cè)試同事，他們會(huì)關(guān)注各種細(xì)節(jié)邊界，這讓我覺得需求文檔上寫的需求過于簡(jiǎn)單了。

這種情況也不是一開始就暴露了，在需求評(píng)審和測(cè)試用例評(píng)審的時(shí)候，可能是大家都在原有的模式中，比較關(guān)注主線邏輯，因此對(duì)這些細(xì)節(jié)并沒有在意。

這導(dǎo)致測(cè)試過程中發(fā)現(xiàn)這些問題時(shí)，開發(fā)覺得需求增加了。這樣很影響項(xiàng)目的正常交付，未來也不好預(yù)估工期。

因此我整理這份需求文檔的自檢清單，防止設(shè)計(jì)過程中的遺留和問題。

關(guān)于需求文檔的自檢清單，我主要分三個(gè)方面：從文檔表達(dá)上、界面交互上和邏輯上。

一、文檔表達(dá)

我認(rèn)為好的文檔，最基礎(chǔ)的就是表達(dá)上能讓開發(fā)測(cè)試清楚的知道需求，減少反復(fù)的需求確認(rèn)，因此我把它作為第一點(diǎn)。

1. 錯(cuò)別字

對(duì)于錯(cuò)別字，很容易導(dǎo)致一些誤會(huì)，讓開發(fā)理解錯(cuò)誤的需求?；蛘邔?duì)于一些系統(tǒng)提示，粗心的開發(fā)會(huì)直接根據(jù)文檔復(fù)制粘貼，不進(jìn)行檢查，這樣的結(jié)果就是系統(tǒng)提示是帶有錯(cuò)別字的提示。

所以這一定是我們要敲響鳴鐘的第一點(diǎn)，不能寫錯(cuò)別字。

2. 言語通順性

團(tuán)隊(duì)里有一個(gè)小姑娘，每次寫出的文檔，表達(dá)出來的意思要么很口頭，要么讀起來和需求像是兩個(gè)意思，甚至語言都不通順。

我對(duì)她的建議是：每次寫好文檔，都自己反復(fù)的去讀，讓語句能夠通順；如果實(shí)在不行，就看看其他人優(yōu)秀的文檔，是如何進(jìn)行表達(dá)的，進(jìn)行模仿著寫。但一定要自己反復(fù)讀自己的文檔，確認(rèn)言語是通順的。

3. 語言表達(dá)的簡(jiǎn)單整潔

這種情況是對(duì)于一個(gè)比較復(fù)雜的交互和邏輯，有時(shí)候很容易在表達(dá)上變得很拗口。

雖然意思的一樣的，開發(fā)在理解后也是沒問題的，但是讀起來就是需要花一定時(shí)間去理解；這會(huì)加大雙方的溝通成本，開發(fā)會(huì)確認(rèn)自己是否有理解錯(cuò)誤。

個(gè)人對(duì)這種情況的描述，一般情況下是盡量進(jìn)行拆分，把邏輯分層段。能進(jìn)行舉例說明的都進(jìn)行舉例說明。

二、界面交互

在界面交互上，對(duì)于只陷在主線邏輯是否走通的思維里時(shí)，往往會(huì)忽略很多異常情況。

1. 界面布局

最基本的，就是界面設(shè)計(jì)時(shí)的布局一致性等。這主要靠設(shè)計(jì)原則來規(guī)避，具體可根據(jù)“尼爾森十大可用性原則”進(jìn)行自檢。

2. 非正向操作

用戶按流程進(jìn)行正向的操作的時(shí)候就是我們?cè)镜脑O(shè)計(jì)，但實(shí)際情況中，如果用戶沒有按照正向流程進(jìn)行使用，且系統(tǒng)不進(jìn)行提示，這很容易對(duì)系統(tǒng)數(shù)據(jù)產(chǎn)生影響；或者因?yàn)殚_發(fā)沒有考慮到這種情況，導(dǎo)致流程卡住不能正常進(jìn)行。

因此在需求設(shè)計(jì)時(shí)，就需要考慮多種非正向操作的情況，對(duì)于非正向操作進(jìn)行正向操作的提示或流程的阻礙。

3. 數(shù)據(jù)計(jì)算異常

因?yàn)槭巧婕暗挠?jì)算邏輯比較多，參數(shù)的未維護(hù)或者維護(hù)錯(cuò)誤、中間過程計(jì)算異常，都會(huì)導(dǎo)致最終結(jié)果無法展示。

若產(chǎn)品中未考慮這些情況，當(dāng)出現(xiàn)數(shù)據(jù)計(jì)算異常時(shí)，用戶甚至不知道是哪里出的錯(cuò)誤，只能求助于服務(wù)公司。

因此，友好的提示：能夠快速讓用戶意識(shí)到錯(cuò)誤點(diǎn)在哪里，快速的將流程走下去，而不是花人力去尋找一些簡(jiǎn)單的問題，浪費(fèi)業(yè)務(wù)的時(shí)間。

4. 數(shù)據(jù)填寫的異常

這個(gè)其實(shí)很多情況是上一個(gè)“數(shù)據(jù)計(jì)算異常”的前置條件，如輸入的數(shù)據(jù)格式不正確、輸入的數(shù)據(jù)過長(zhǎng)、輸入的數(shù)據(jù)為空，這些都很容易導(dǎo)致后續(xù)的計(jì)算出錯(cuò)。

輸入的數(shù)據(jù)在邏輯上處于什么作用也需進(jìn)行分析，需要根據(jù)邏輯來判斷是否要對(duì)該數(shù)據(jù)增加其他校驗(yàn)。

三、邏輯

因?yàn)槭菙?shù)據(jù)系統(tǒng)，邏輯上的問題會(huì)比較多。

我們有專門的數(shù)據(jù)分析團(tuán)隊(duì)，他們會(huì)給我進(jìn)行一些特殊數(shù)據(jù)上的特殊邏輯處理，但是實(shí)際的業(yè)務(wù)數(shù)據(jù)中還是會(huì)出現(xiàn)一些我們考慮不全面的情況。

1. 邏輯上是否閉合、是否存在斷層

一般在數(shù)據(jù)分析提供給我們邏輯時(shí)，我們會(huì)進(jìn)行邏輯圖的繪制。這一過程中，邏輯是否走通、是否存在斷層比較容易發(fā)現(xiàn)，這一習(xí)慣能保證正向邏輯上不存在漏洞。

2. 存在極端值的情況

雖然數(shù)據(jù)分析是通過實(shí)際值進(jìn)行檢驗(yàn)邏輯的正確性的，但因?yàn)闃颖緮?shù)據(jù)過小或者樣本數(shù)據(jù)中不存在極端值的情況，所以很容易在測(cè)試同事測(cè)試時(shí)造了極端值或者在客戶遇到了極端情況下才暴露出問題。

這些極端值是存在共性的，因此把遇到極端值的情況進(jìn)行羅列，在后續(xù)的文檔編寫時(shí)進(jìn)行對(duì)照，能避免反復(fù)遇到同類問題。

四、總結(jié)

自檢清單的對(duì)照，是為了讓我們吸取教訓(xùn)。

在今后的文檔編寫時(shí)，更注重輸出文檔的需求準(zhǔn)確性和邏輯嚴(yán)密性。讓人一讀文檔就知道需求是什么，且開發(fā)的系統(tǒng)是完善的。

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

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