写产品文档是产品经理基本的技能之一，从开始接触到熟练写出文档，需要一段时间去理解消化，然后输出。一开始工作进入公司新的开发项目，接到写需求文档的任务，当时直接按照模板把功能需求都套进去，觉得不是很难。需求评审完后，就把文档发给开发，结果收到了密密麻麻批注的修改建议。这才发现写一份合格的产品文档没看起来那么容易，按照要求改了了三遍才算初步通过，过程中备受心灵上的煎熬。
从此之后每每写文档，便对撰写文档需要注意的地方进行记录，最后一合计发现已经写了好几页，现在将这些零散的内容稍加整理，希望帮助自己不断完善文档的内容，适应开发团队的使用习惯，将功能需求表达清楚。确定要做一个需求之前，我都会先与开发沟通该需求是否能够实现，以及实现时间，哪种实现方式节约资源，对现有结构影响较小，且具有可拓展性。下面把这些内容归纳为十个部分分享给大家，希望对你们也有帮助。
1.文档撰写前先要理清楚每个业务的流程及逆向流程，流程中涉及的功能及页面。考虑各个使用者角色获取的权限和所显示功能，业务流程是否冲突，功能内容是否一致。
2.每一个页面可到达的页面和可进入该页面的上级页面有哪些（是否扁平化？）。页面哪些内容可进行操作，比如图标，图片，文字，电话，链接等。每个动作引发的下一交互和对某一元素的操作需描述的尽量详尽，逻辑跳转与页面元素在操作过程中是否发生变化（动画，隐藏等）。
3.分清客户端与服务器处理的信息分别是什么，哪些判断规则可直接在本地加入，哪些信息需要服务器做判断，比如注册时的对手机号格式判断在本地完成，可减轻服务器压力。涉及需向服务器发送请求的操作，请求失败，超时，网络不佳等异常情况时如何提示。
4.刷新机制，有新消息或者动态时，页面刷新方式是点击还是滑动刷新，如何进行提示？数据更改后是否需要立即刷新，其他设备的页面内容何时刷新，以什么形式更新。进入某一页面，该页面有新内容时，如何对内容进行排序？
5.缓存，点击某个页面，该页面内容的初始加载，预加载，和触发后加载显示内容分别是哪些。每个页面哪些需要缓存，哪些不需要。
6.一个页面所需的字段有哪些。比如公众号中（公众号id，用户id，消息类型，消息标题，副标题，内容，时间，链接等内容），这些数据是否需要实时更新，还是在进行某一特定操作后进行更新。
7.输入框和按钮，点击前，点击时，点击后，输入前，输入后，清空等不同状态下的显示。以及填写完表单后，提交后显示的提示内容。同时考虑键盘的兼容性，唤出键盘的高度和类型。
8.删除和取消操作后，被删除或者做取消操作时所涉及的内容是否可找回（比如公众号中取消关注后，公众号历史消息是否可查看）。理清增删操作所带来的用户数量，内容的变化，以及该操作是否需推送相关通知。
9.页面元素适配，安卓与iOS界面，操作与页面元素不同的地方需要两套交互和页面设计。并考虑各个不同设备界面内容表达意思是否一致，符合不同用户的使用习惯。
10.经访问，我司开发人员在文档中最关注的是每个页面需要实现的功能，以及对实现功能的页面设计和交互说明。开发喜欢图胜于文字，能用图表达清楚的最好用图表达出来，这点非常重要！
写过很多产品文档，仍然走在成长的路上。文档的思路和细节体现了一个产品经理如何理解，实现需求的能力和逻辑思维能力。这一过程中，需要与多方进行沟通，确保文档输出后的可行性，也体现了部分沟通能力，这几项基本技能是产品经理技能树中不可缺少的部分。新人写的文档可能或多或少都有些问题，只要多加总结和思考，一定会有所进步。
我的微信号是：koala344699754
希望能认识一些产品人，可以一起探讨问题，共同成长。
