編輯導(dǎo)讀：寫好原型文檔是產(chǎn)品經(jīng)理的一項基本功，因為業(yè)務(wù)和開發(fā)都需要看懂原型文檔，所以原型文檔需要寫得簡單清晰。本文作者基于自身經(jīng)驗，分析原型文檔在書寫時要注意的幾個點，與你分享。

產(chǎn)品經(jīng)理在工作中離不開原型文檔，原型文檔具有直觀性，讓業(yè)務(wù)和開發(fā)都容易看懂。

通常業(yè)務(wù)更注重看原型里面的頁面，而開發(fā)則更注重看文檔。

通常原型文檔還是開發(fā)用的時間比較長，開發(fā)在開發(fā)過程還需要繼續(xù)使用原型文檔，充分理解自己要做的事情。

為了增加文檔的可讀性和理解性，以下內(nèi)容一定要寫清楚，避免開發(fā)不斷詢問。

1. 交互動效

交互動效在頁面中很常見，比如下拉、置頂、tab切換、彈層、浮層、hover等等，還有很多超贊的交互動效，這里就不一一列出。所以對于產(chǎn)品需要的交互動效要描述清楚，這樣前端才知道要做成什么樣。

舉例子：

從這張圖，可以看出是涉及到交互的地方就是月份選擇，需要描述清楚點擊出現(xiàn)還是hover出現(xiàn)；采用統(tǒng)一下拉控件還是特殊做下拉效果。

而對于下拉列表中的內(nèi)容也需要描述清楚，從哪個月份開始取值，今年還是去年，從哪個月份開始。如果沒有將清楚，之后開發(fā)還是需要詢問，后面也是要補充的。因為你不能只給開發(fā)講了就行，如果PC端和H5端不同的開始人員呢？測試也是需要按照這份文檔進行測試，不清楚的模塊，測試無法測試。

可供參考描述如下：

2. 跳轉(zhuǎn)鏈接的位置及狀態(tài)

頁面中通常會有鏈接的位置，這是就需要清楚的將需要鏈接的位置單獨指明出來。如果需要鏈接有不同的狀態(tài)也需要單獨標(biāo)出。

舉例子：

這個頁面，如果什么都不寫，前端開發(fā)很難知道到底需不需要鏈接，哪些地方需要鏈接，鏈接到哪個頁面，所以前端將無法工作。

這時需要清楚的寫出：

車圖、車系名稱、銷量是否需要帶鏈接，是否需要hover態(tài)？Hover效果如何？當(dāng)然前端最喜歡的是直接告知參考哪個網(wǎng)頁的動效。產(chǎn)品可以當(dāng)面溝通，也可以直接將參考網(wǎng)址鏈接復(fù)制到文檔說明中。

這些都要寫清楚，除非你不在效果。因為做本次產(chǎn)品的時候，由于本人沒有寫銷量需要帶鏈接，前端就沒有在銷量出帶鏈接，導(dǎo)致用戶只能通過車圖和車系名稱點擊進入車系詳情，稍微靠近銷量就無法點擊跳轉(zhuǎn)。

3. 取值位置和取值邏輯要寫清楚

頁面上會有很多圖片和文案，這是產(chǎn)品就需要寫清楚，取值位置和取值邏輯。

舉例子：

這個頁面，如果不講清楚車圖取值位置和取值邏輯，開發(fā)會把文檔給拍回來。

這個圖片的取值相對來說比較復(fù)雜，首先要考慮圖片從哪里來了，因為這里是車型圖，由于公司圖片較少，會出現(xiàn)車型圖沒有的情況，而為了頁面展示的美觀，最好有圖。這是就會有很多中方案，比如沒圖就不展示空著；或者取主推車型；或者取車系封圖等等。這時候就需要產(chǎn)品經(jīng)理去權(quán)衡利弊給出合理的取值邏輯。

當(dāng)時出于準(zhǔn)確性以及滿足盡量有車圖的需求，給出的方案是：優(yōu)先車型圖片-主推車型車圖-車系封圖。

4. 涉及到算法的，給出計算公式

算法和計算公式一般是后端必要的。產(chǎn)品有時對后臺數(shù)據(jù)庫不是很熟悉，這是必須先熟悉，才能知道你想得到的結(jié)果是如何實現(xiàn)的。

尤其對于新項目，所有人都不清楚數(shù)據(jù)有哪些，要如何計算這些數(shù)據(jù)才能得到想要的結(jié)果。這是產(chǎn)品就需要通過自己的驗證方法來得到一個合適的計算公式，然后寫在文檔中，告知開發(fā)。

計算公式有太多種方式，找到能得到自己目標(biāo)的方式即可。

5. 極限情況

極限情況多指正常情況之外的。其實在頁面設(shè)計中還蠻常見，所以不要遺漏。有時候產(chǎn)品和開發(fā)都忘記的極限情況，那么上線后就會造成頁面混亂，導(dǎo)致用戶體驗變差。

常見：文字過長、圖片縮放、無內(nèi)容、報錯等

文字過長。比如下圖中品牌車系車型名稱一行放不下，就可以拆成兩行，當(dāng)兩行還是過多時就需要截斷或者增加“…”或者繼續(xù)折行展示

無內(nèi)容。比如下圖中資訊無內(nèi)容，可以隱藏該模塊，或者做好無內(nèi)容的文案提醒。

6. 默認(rèn)值

默認(rèn)值指用戶第一次展開打開頁面展示的內(nèi)容，當(dāng)用戶登錄或者不登錄狀態(tài)下是否有變化，如果有變化，都需要單獨列出。

比如下圖中的表單，在用戶未登錄的時候，默認(rèn)值為提示語，而在用戶登錄的時候，則姓名和手機號默認(rèn)值可以是用戶已經(jīng)填過的姓名和手機號。

默認(rèn)值的選擇，以方便用戶使用為目標(biāo)。

7. 不要只寫前臺文檔，后臺也需要寫的

如果涉及的內(nèi)容需要后臺開發(fā)單獨的內(nèi)容，那么也要跟前臺一樣的邏輯，畫出原型，寫說明文檔。

并且在后臺的說明文檔中文案最好與前臺一致，這樣開發(fā)可以很清楚的知道后臺上傳的內(nèi)容在前臺對應(yīng)的內(nèi)容。如果文案不能保持統(tǒng)一，那么一定要單獨在后臺說明文檔中，寫清楚對應(yīng)的前臺展示。

8. 修改一定要進行記錄

有些產(chǎn)品較為復(fù)雜，在開發(fā)過程中才會發(fā)現(xiàn)問題，就需要對原型進行修改。為了讓大家清楚修改了什么，需要在原型的開頭增加一個修改記錄，將每次修改的內(nèi)容寫清楚，以及針對的頁面以及改后的版本后。在工作群中，將最新的修改記錄發(fā)給大家，同時附上最新的原型下載地址。

原型文檔注意點先整理這些，大家在工作需要不斷積累其他的經(jīng)驗，這樣才會讓文檔更適合開發(fā)使用，合作起來才會更順利。

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

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