本页将介绍如何识别受众、开展用户研究,并以他们的需求为导向进行写作。
为多个受众写作常常会导致折中,结果谁也不满意。每篇内容都应聚焦于一个特定的用户画像。
你的受众可能是:
- 评估你产品的技术决策者,他们希望了解更高层面的信息,如架构概览。
- 第一次接触你产品的新用户,他们希望尽快上手。
- 负责集成你产品的开发者,他们需要针对特定任务的操作指南。
在撰写任何页面之前,先问:读者想达成什么目标?他们已有的相关知识是什么?
你的团队应就主要受众达成一致,但不要只凭直觉。最有价值的洞察来自直接与用户交流。我们对自身产品的设想与用户的实际使用方式之间常常存在差距。
与用户交流以了解:
- 他们如何描述你的产品的作用?
- 他们是否会使用出乎意料的词汇或名称来描述你的产品?
- 他们希望在哪些方面获得更多了解?
- 你的文档中明确缺少哪些内容?
直接与用户沟通有助于从用户视角校准你的写作,从而编写对他们有用、并能帮助他们更接近目标的文档。
- 深入对接支持团队。 你将直观看到文档不完整带来的痛点。向支持团队了解用户如何看待产品,以及他们最常遇到的问题。
- 引入反馈机制。 无论是点赞/点踩还是纯文本输入,都应让用户在阅读文档时有机会提供反馈。
- 使用 Analytics 进行指导。 审查反馈与洞察,了解用户在哪些地方遇到困难、在哪些地方顺利完成。优先更新那些用户最易受阻或与产品关键任务最相关的文档。
总会有文档无法覆盖的边缘情况。优先处理影响最大、能帮助最多人的页面。内容过多会增加导航与维护成本,试图覆盖所有情形可能适得其反。