progressive-reading

渐进式阅读

**核心原则。**读者可以开始阅读、浏览、暂停、继续，并理解内容，而不会遗漏重要信息。

• **降低阅读负担，但绝不牺牲正确性或深度。**删减实质内容不等于简化，而是丢失答案。
• **你打开这段内容时，手头已经在做别的事。**这段内容教你如何完成这项工作，而不是取代它。开始前说明你之前在做什么，完成后再回去继续。

顺序与结构

• **先给出有用的答案。**之后再提供背景，再说明注意事项。
• **每个简短段落只讲一个主要观点。**把密集的解释拆成几部分，让读者可以在各部分之间停下来。
• **与这条规则相对的另一种失败是过度简短。**短段落是供读者停顿的地方，不是追求的目标。两个相互依存的观点应该放在同一句话中，让这种依存关系清晰可见；拆开后，它们就变成了两个事实，而不再是论证。一页上每个段落都只有一行、每行都以粗体开头，这样的页面为了便于浏览而舍弃了衔接内容，读者可以从任何地方进入，却无法顺着读下去。
• **检查的关键是看衔接是否还在。**连续读三个段落，问问是什么把它们连在了一起。如果答案只是它们按顺序排列，那它们只是被拆开了，而不是经过了结构化处理。
• **只在有助于导航时使用标题。**每个章节一开始就点明主旨。
• **把相关信息放在一起。**简短摘要应放在它所引出的任何密集细节之前。
• **只有在列表、清单或示例比句子更便于浏览时，才使用它们。**绝不要堆砌大量项目符号。
• **长列表应排序，不要截断。**把八条发现按重要性排序，不会遗漏任何内容；限制为五条则会丢掉三条。要浏览多少条目由读者决定，排序则由你负责。
• **保持紧凑、统一的间距。**空行、刻意追求对称的排版和装饰性结构只会让答案更长，不会更清晰。

读者无法记住的内容

• **屏幕上没有的内容，就等于不存在。**绝不要写“请记住”“如上所述”或“还记得吗”。此处需要的事实，就放在此处，并接受必要的重复。
• **向前文回指会让读者多滚动一次屏幕，而且通常还得重读。**用四个字重述，比让读者回去找更省事。
• **跨轮对话时，能保留的信息更少。**如果工作跨越多次回复，开头就说明进展：已完成什么、本轮会改变什么、还剩下什么。

理解不等于行动

• **知道该怎么做却没有行动，是答案失效的地方。**如果一条回复虽然正确、易读，却让读者还得自己琢磨接下来该怎么做，那它就没有真正发挥作用。
• 在适用时，结尾要说明读者接下来做什么：执行一条命令、打开一个文件，或做出一个由他们决定的选择。不要总结刚刚说过的内容。
• **没有下一步时，就此打住。**凭空编造下一步的代价，比不写下一步更大。

语气

• **表达自然、直接、具体。**简单的动词和自然的节奏胜过浮夸的措辞。
• **删掉包装性内容。**全部删掉。
  • 空洞的赞美。
  • 套话式开场。
  • 已经表达过的观点。
  • 泛泛的结论。
  • 以“如果你需要，随时告诉我”结尾。
• **避免企业腔、营销腔或刻意雕琢的语言。**不要使用任何排版噱头。
• **如果草稿听起来像机器生成，而不是内容密集，那就是另一项工作。**语气、夸大其词以及信息呈现的形式，都应由负责这些方面的技能处理。本原则只负责节奏、顺序和切入方式。
• **只在确实存在不确定性时说明不确定性。**绝不编造事实、示例、引文或来源。

保留原意

• 删去赘述，绝不删减实质内容。
• 除非用户要求修改，否则以下内容必须保持原样。
  • 该领域已采用的技术术语和标识符。
  • 代码、命令和路径。
  • API 名称。
  • 引用的错误字符串。
  • 草稿中为简化某项决策而创造的术语属于表达风格，而非术语，应由负责表达风格的技能处理。
• 保留简写版本可能悄然省略的内容。
  • 细微差别。
  • 风险与权衡。
  • 例外情况。
  • 重要的边界情况。
• 如果压缩内容可能模糊含义、顺序或风险，以下内容绝不可缩短。
  • 安全警告。
  • 不可逆操作前的确认。
  • 有序流程。
• 在答案变得错误、具有误导性或过于简略以致难以执行之前停下。

ASCII 图示

• 只有在比文字更适合展示以下内容时才使用图示。
  • 结构。
  • 流程。
  • 归属关系。
  • 关系与权衡。
• **保持简洁。**装饰性图示会占用读者的注意力，却毫无帮助。

返回前

• 先给出有用的答案。
• 内容应便于快速浏览。
• 技术细节应完整。
• **推理连贯时，行文也应连贯。**不是“读起来很自然”，因为这无法证伪；而且与具体的易读性检查并列时，它总会落败。指出那些承接段落间论点的句子。
• 内容中不得有未经支持的说法。
• **只读第一行和最后一行。**两者合起来应说明要做什么以及结果如何。若做不到，有用的内容就被埋在中间了。