? ? ? 寫產品文檔是產品經理基本的技能之一，從開始接觸到熟練寫出文檔，需要一段時間去理解消化，然后輸出。一開始工作進入公司新的開發項目，接到寫需求文檔的任務，當時直接按照模板把功能需求都套進去，覺得不是很難。需求評審完后，就把文檔發給開發，結果收到了密密麻麻批注的修改建議。這才發現寫一份合格的產品文檔沒看起來那么容易，按照要求改了了三遍才算初步通過，過程中備受心靈上的煎熬。

? ? ? 從此之后每每寫文檔，便對撰寫文檔需要注意的地方進行記錄，最后一合計發現已經寫了好幾頁，現在將這些零散的內容稍加整理，希望幫助自己不斷完善文檔的內容，適應開發團隊的使用習慣，將功能需求表達清楚。確定要做一個需求之前，我都會先與開發溝通該需求是否能夠實現，以及實現時間，哪種實現方式節約資源，對現有結構影響較小，且具有可拓展性。下面把這些內容歸納為十個部分分享給大家，希望對你們也有幫助。

1.文檔撰寫前先要理清楚每個業務的流程及逆向流程，流程中涉及的功能及頁面。考慮各個使用者角色獲取的權限和所顯示功能，業務流程是否沖突，功能內容是否一致。

2.每一個頁面可到達的頁面和可進入該頁面的上級頁面有哪些（是否扁平化？）。頁面哪些內容可進行操作，比如圖標，圖片，文字，電話，鏈接等。每個動作引發的下一交互和對某一元素的操作需描述的盡量詳盡，邏輯跳轉與頁面元素在操作過程中是否發生變化（動畫，隱藏等）。

3.分清客戶端與服務器處理的信息分別是什么，哪些判斷規則可直接在本地加入，哪些信息需要服務器做判斷，比如注冊時的對手機號格式判斷在本地完成，可減輕服務器壓力。涉及需向服務器發送請求的操作，請求失敗，超時，網絡不佳等異常情況時如何提示。

4.刷新機制，有新消息或者動態時，頁面刷新方式是點擊還是滑動刷新，如何進行提示？數據更改后是否需要立即刷新，其他設備的頁面內容何時刷新，以什么形式更新。進入某一頁面，該頁面有新內容時，如何對內容進行排序？

5.緩存，點擊某個頁面，該頁面內容的初始加載，預加載，和觸發后加載顯示內容分別是哪些。每個頁面哪些需要緩存，哪些不需要。

6.一個頁面所需的字段有哪些。比如公眾號中（公眾號id，用戶id，消息類型，消息標題，副標題，內容，時間，鏈接等內容），這些數據是否需要實時更新，還是在進行某一特定操作后進行更新。

7.輸入框和按鈕，點擊前，點擊時，點擊后，輸入前，輸入后，清空等不同狀態下的顯示。以及填寫完表單后，提交后顯示的提示內容。同時考慮鍵盤的兼容性，喚出鍵盤的高度和類型。

8.刪除和取消操作后，被刪除或者做取消操作時所涉及的內容是否可找回（比如公眾號中取消關注后，公眾號歷史消息是否可查看）。理清增刪操作所帶來的用戶數量，內容的變化，以及該操作是否需推送相關通知。

9.頁面元素適配，安卓與iOS界面，操作與頁面元素不同的地方需要兩套交互和頁面設計。并考慮各個不同設備界面內容表達意思是否一致，符合不同用戶的使用習慣。

10.經訪問，我司開發人員在文檔中最關注的是每個頁面需要實現的功能，以及對實現功能的頁面設計和交互說明。開發喜歡圖勝于文字，能用圖表達清楚的最好用圖表達出來，這點非常重要！

? ? ? 寫過很多產品文檔，仍然走在成長的路上。文檔的思路和細節體現了一個產品經理如何理解，實現需求的能力和邏輯思維能力。這一過程中，需要與多方進行溝通，確保文檔輸出后的可行性，也體現了部分溝通能力，這幾項基本技能是產品經理技能樹中不可缺少的部分。新人寫的文檔可能或多或少都有些問題，只要多加總結和思考，一定會有所進步。

我的微信號是：koala344699754

希望能認識一些產品人，可以一起探討問題，共同成長。