了解你的受众

以用户目标为写作核心

本页介绍如何识别受众、开展用户研究，并在写作中始终以其需求为先。

​

明确你的主要受众

为多个受众写作常常会导致折中，结果谁也不满意。每篇内容都应聚焦于一个特定的用户画像。

你的受众可能是：

• 评估你产品的技术决策者，他们希望了解更高层面的信息，如架构概览。
• 第一次接触你产品的新用户，他们希望尽快上手。
• 负责集成你产品的开发者，他们需要针对特定任务的操作指南。

在撰写任何页面之前，先问：读者想达成什么目标？他们已有的相关知识是什么？

​

用户研究至关重要

你的团队应就主要受众达成一致，但不要只凭直觉。最有价值的洞察来自直接与用户交流。我们对自身产品的设想与用户的实际使用方式之间常常存在差距。

与用户交流以了解：

• 他们如何描述你的产品的作用？
• 他们是否会使用出乎意料的词汇或名称来描述你的产品？
• 他们希望在哪些方面获得更多了解？
• 你的文档中明确缺少哪些内容？

直接与用户沟通有助于从用户视角校准你的写作，从而编写对他们有用、并能帮助他们更接近目标的文档。

​

理解受众的实用技巧

1. 深入对接支持团队。 你将直观看到文档不完整带来的痛点。向支持团队了解用户如何看待产品，以及他们最常遇到的问题。
2. 引入反馈机制。 无论是点赞/点踩还是纯文本输入，都应让用户在阅读文档时有机会提供反馈。
3. 使用 Analytics 进行指导。 审查反馈与洞察，了解用户在哪些地方遇到困难、在哪些地方顺利完成。优先更新那些用户最易受阻或与产品关键任务最相关的文档。

总会有文档无法覆盖的边缘情况。优先处理影响最大、能帮助最多人的页面。内容过多会增加导航与维护成本，试图覆盖所有情形可能适得其反。