> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# 了解你的受众

> 让用户目标始终成为文档的核心。

<Tip>
  本页将介绍如何识别受众、开展用户研究，并以他们的需求为导向进行写作。
</Tip>

<div id="identify-your-primary-audience">
  ## 明确你的主要受众
</div>

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

你的受众可能是：

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

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

<div id="user-research-is-key">
  ## 用户研究至关重要
</div>

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

与用户交流以了解：

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

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

<div id="tips-and-tricks-for-understanding-your-audience">
  ## 理解受众的实用技巧
</div>

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

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