提供初始上下文。定义主题并说明其与读者的相关性。
按逻辑顺序构建内容，并按重要性和相关性排序。按优先级排序信息，并按用户需要的信息顺序排序。
避免使用长句子和长段落.
- 逐一介绍概念。
- 每段落阐述一个观点。
- 每个句子表达一个观点。
强调最重要的信息.
- 以最重要的词语和要点开头每个句子或段落。
- 在解释概念时，先从结论开始，然后详细解释。（这有时称为“倒金字塔”）。
- 在解释复杂主题时，先向读者提供基本信息，然后在文章后面详细说明。
使用有意义的小标题。将相关段落组织成部分。为每个部分提供唯一且准确描述内容的小标题。
考虑在较长的内容中使用页面内链接。这允许读者跳到感兴趣的区域并跳过与他们无关的内容。

撰写易读的内容

让忙碌的用户能够轻松阅读和理解文本。

有关相关信息，请参阅样式指南中的“语气和语调”以及撰写可翻译的内容。

格式化以方便扫描

大多数读者不会完整阅读文章。相反，他们要么扫描页面以查找特定信息，要么略读页面以了解概念的大致情况。

在扫描或略读内容时，读者会跳过大量文本。他们会寻找与他们的任务相关的或在页面上脱颖而出的元素，例如标题、警报、列表、表格、代码块、视觉效果以及每个部分的前几个词语。

一旦文章具有明确定义的目的和结构，您可以应用以下格式化技术来优化内容以供扫描和略读。这些技术还可以帮助使所有读者都能更好地理解内容。

使用文本突出显示（例如粗体和超链接）来引起读者对最重要点的注意。谨慎使用文本突出显示。不要突出显示文章中超过 10% 的文本。
使用格式化元素分隔内容并在页面上创建空间。例如
- 项目符号列表（可选带缩进式副标题）
- 编号列表
- 警报
- 表格
- 视觉效果
- 代码块和代码注释