? ? ? 寫產(chǎn)品文檔是產(chǎn)品經(jīng)理基本的技能之一将饺，從開始接觸到熟練寫出文檔贡避，需要一段時間去理解消化痛黎，然后輸出。一開始工作進入公司新的開發(fā)項目刮吧，接到寫需求文檔的任務(wù)湖饱，當(dāng)時直接按照模板把功能需求都套進去，覺得不是很難杀捻。需求評審?fù)旰缶幔桶盐臋n發(fā)給開發(fā)，結(jié)果收到了密密麻麻批注的修改建議致讥。這才發(fā)現(xiàn)寫一份合格的產(chǎn)品文檔沒看起來那么容易仅仆，按照要求改了了三遍才算初步通過，過程中備受心靈上的煎熬垢袱。

? ? ? 從此之后每每寫文檔墓拜，便對撰寫文檔需要注意的地方進行記錄，最后一合計發(fā)現(xiàn)已經(jīng)寫了好幾頁请契，現(xiàn)在將這些零散的內(nèi)容稍加整理咳榜，希望幫助自己不斷完善文檔的內(nèi)容，適應(yīng)開發(fā)團隊的使用習(xí)慣爽锥，將功能需求表達清楚涌韩。確定要做一個需求之前，我都會先與開發(fā)溝通該需求是否能夠?qū)崿F(xiàn)氯夷，以及實現(xiàn)時間臣樱，哪種實現(xiàn)方式節(jié)約資源，對現(xiàn)有結(jié)構(gòu)影響較小腮考，且具有可拓展性擎淤。下面把這些內(nèi)容歸納為十個部分分享給大家，希望對你們也有幫助秸仙。

1.文檔撰寫前先要理清楚每個業(yè)務(wù)的流程及逆向流程嘴拢，流程中涉及的功能及頁面〖偶停考慮各個使用者角色獲取的權(quán)限和所顯示功能席吴，業(yè)務(wù)流程是否沖突赌结，功能內(nèi)容是否一致。

2.每一個頁面可到達的頁面和可進入該頁面的上級頁面有哪些（是否扁平化孝冒？）柬姚。頁面哪些內(nèi)容可進行操作，比如圖標(biāo)庄涡，圖片量承，文字，電話穴店，鏈接等撕捍。每個動作引發(fā)的下一交互和對某一元素的操作需描述的盡量詳盡，邏輯跳轉(zhuǎn)與頁面元素在操作過程中是否發(fā)生變化（動畫泣洞，隱藏等）忧风。

3.分清客戶端與服務(wù)器處理的信息分別是什么，哪些判斷規(guī)則可直接在本地加入球凰，哪些信息需要服務(wù)器做判斷狮腿，比如注冊時的對手機號格式判斷在本地完成，可減輕服務(wù)器壓力呕诉。涉及需向服務(wù)器發(fā)送請求的操作缘厢，請求失敗，超時甩挫，網(wǎng)絡(luò)不佳等異常情況時如何提示贴硫。

4.刷新機制，有新消息或者動態(tài)時捶闸，頁面刷新方式是點擊還是滑動刷新夜畴，如何進行提示？數(shù)據(jù)更改后是否需要立即刷新删壮，其他設(shè)備的頁面內(nèi)容何時刷新贪绘，以什么形式更新。進入某一頁面央碟，該頁面有新內(nèi)容時税灌，如何對內(nèi)容進行排序？

5.緩存亿虽，點擊某個頁面菱涤，該頁面內(nèi)容的初始加載，預(yù)加載洛勉，和觸發(fā)后加載顯示內(nèi)容分別是哪些粘秆。每個頁面哪些需要緩存，哪些不需要收毫。

6.一個頁面所需的字段有哪些攻走。比如公眾號中（公眾號id殷勘，用戶id，消息類型昔搂，消息標(biāo)題玲销，副標(biāo)題，內(nèi)容摘符，時間贤斜，鏈接等內(nèi)容），這些數(shù)據(jù)是否需要實時更新逛裤，還是在進行某一特定操作后進行更新瘩绒。

7.輸入框和按鈕，點擊前别凹，點擊時草讶，點擊后洽糟，輸入前炉菲，輸入后，清空等不同狀態(tài)下的顯示坤溃。以及填寫完表單后拍霜，提交后顯示的提示內(nèi)容。同時考慮鍵盤的兼容性薪介，喚出鍵盤的高度和類型祠饺。

8.刪除和取消操作后，被刪除或者做取消操作時所涉及的內(nèi)容是否可找回（比如公眾號中取消關(guān)注后汁政，公眾號歷史消息是否可查看）道偷。理清增刪操作所帶來的用戶數(shù)量，內(nèi)容的變化记劈，以及該操作是否需推送相關(guān)通知勺鸦。

9.頁面元素適配，安卓與iOS界面目木，操作與頁面元素不同的地方需要兩套交互和頁面設(shè)計换途。并考慮各個不同設(shè)備界面內(nèi)容表達意思是否一致，符合不同用戶的使用習(xí)慣刽射。

10.經(jīng)訪問军拟，我司開發(fā)人員在文檔中最關(guān)注的是每個頁面需要實現(xiàn)的功能，以及對實現(xiàn)功能的頁面設(shè)計和交互說明誓禁。開發(fā)喜歡圖勝于文字懈息，能用圖表達清楚的最好用圖表達出來，這點非常重要摹恰！

? ? ? 寫過很多產(chǎn)品文檔辫继，仍然走在成長的路上阁最。文檔的思路和細節(jié)體現(xiàn)了一個產(chǎn)品經(jīng)理如何理解，實現(xiàn)需求的能力和邏輯思維能力骇两。這一過程中速种，需要與多方進行溝通，確保文檔輸出后的可行性低千，也體現(xiàn)了部分溝通能力配阵，這幾項基本技能是產(chǎn)品經(jīng)理技能樹中不可缺少的部分。新人寫的文檔可能或多或少都有些問題示血，只要多加總結(jié)和思考棋傍，一定會有所進步。

我的微信號是：koala344699754

希望能認(rèn)識一些產(chǎn)品人难审，可以一起探討問題瘫拣，共同成長。