程序员|如何写一个完整的交互说明文档？( 二 ) 用户|管理|产品|品牌|阅流|视频

我刚入行的时候那时候只是产品助理，遇到过一个情况：有一个项目，由两个产品经理负责，其中一个产品经理写的交互说明写得不够细致，导致程序员没有看懂。程序员就不断地问项目经理，被项目经理痛骂，说他脑子不好使，程序员吃了瘪。
再后来，程序员遇到自己看不懂的地方，就按照自己的想法来，搞得项目一拖再拖。两个人都被人事批了一顿。
从此以后，每当我写交互的时候，我常常反思：该怎么把交互说明写得细致呢？如何一针见血地把要点表达出来？那就要从以下3个维度分析：

按钮、图标等操作以后出现的状态变化。
刷新、加载（上划下滑）、数字显示等页面规则。
错误提醒、弹窗等。

使用过微博的朋友应该了解，当你看到一篇你觉得写的不错的文章时，你给这篇文章点了个赞，它的爱心图标就由空心的爱心变成了红色爱心，并且爱心后面的数字也往上加一。如果超过100万人点赞的话，就会一直显示100万+。这些按钮的变化或者一些数字的显示规则，都需要写到交互说明里面。
你在刷抖音的时候，在刷新的时候，你有没有想过它一次能加载几条视频？我就这么无聊，还真的去数了，但我不记得准确的数字了，好像是30个。如果你在写加载规则的时候，也记得把加载出几条内容也写进规则里面。
我分析过36氪的账号密码登录页面，（除了账号密码登录页面还有验证码登陆页面、一键登录页面）。
例如用户再点击这个区号时，页面会跳出弹窗，这时候我们也得把弹窗的样子画出来，包括弹窗的一些操作规则也得说清楚。
如果用户在输入手机号，会获取光标提示文字消失，尾部出现删除的按钮，这些规则是需要写进交互说明的。
包括用户将手机号格式输入错误时，就是不等于11位开头也不为1时，点击按钮出现的错误提示，请输入正确的手机号。这个错误提示也是需要说明的。
分析一下以上操作时，最好把该页面的全局说明、页面说明、页面权限、使用场景交代清楚。就是要把页面进入的方式，跳转到哪些页面；是VIP才能使用的，还是普通用户也能使用的；用户是在什么样的场景下会使用该页面；等等关于页面的都可以说。这样可以让UI在设计的时候更加个性化、人性化。
3. 步骤三：检查对一些隐藏状态的规则，和错误提醒的设计一定要写清楚限制条件。
比如返回键千万不要忘记画，既然能进入到这个页面，就要能往回退到前一个页面，要能进就能退。
同理，有成功就有失败，你既然能够操作成功，就有操作失败的时候。比如你使用发布功能，如果字数超出限制，就不能发送成功，就会失败，所以这些规则都得制定好。要睁大双眼检查自己可能会出错的地方。
四字真言：增删查改。对于缺少的内容，补充完整。
比如用户在发表评论时，需要限制评论字数，但在交互说明中并没有写，你就需要补充上去，留下能表达出意思的说明即可。如果你从元件库里拖出来的按钮，你还解释了一遍，说明这个解释是不需要的，因为从元件库库里拖出来的按钮，他已经有含义了，不需要你再去解释一遍。
三、总结产品经理在写交互说明的时候，需要不断地提出问题，思考：这个功能要为什么要这么放？它需要怎么变化？用户希望产品是怎么样的？
写清楚操作内容、限制条件，但要拒绝流水账式说明，另外当描述文字过长，看是自己在语言表达上存在问题，还是可能需要重新考虑是否是设计逻辑存在问题。
如果有一些核心功能、重点内容、复杂难懂的交互，可以在必要的情况下，需要先跟团队强调交互说明的存在意义，推动大家去阅读和反馈，才能对产品的发展起到真实有效的作用。如果交付文档后，UI或者程序员实在有看不懂的地方，也要欢迎他们随时来问，避免以后出现更复杂的问题。