Files
Endorphin-Document/authoring/rules/DOC-024.md
T

1.6 KiB

DOC-024 用读者任务验收文档

分类:协作与质量。级别:核心。本规则是项目写作约定,不是语言语义。

规则

除结构检查外,按冷读、定位和结果预测任务检查文档。

原因

文件无格式错误不表示读者已经能够理解或使用它。

执行方法

  1. 冷读:不查看聊天,复述用途、概念关系和一个核心例子。
  2. 定位:只从目录或术语索引寻找指定规则;记录卡住的地方。
  3. 预测:根据例子解释结果、合法边界与提案状态;将人工评审与真实用户测试分别记录。

改写对照

问题写法:139 个链接通过,所以文档一定易懂。

推荐做法:链接检查通过后,再检查读者能否区分归属与引用并预测 90 和 85。

以上是说明写作差异的项目例子,不新增语言能力。

验收

  • 验收任务与页面目标对应。
  • 发现的理解障碍有具体位置。
  • 没有把作者自查冒充真实用户测试。

具体应用

选择相关的复述、定位或预测任务,记录实际卡住的位置。作者走查、独立代理评估和真人测试分别报告;质量不能由链接数量或规则命中数推断。

详见验收标准与行为评估。

依据与边界

SRC-15。来源页记录观察与分析,本页的执行方法是针对项目的综合建议,不宣称由某一原文逐项规定。

规则索引 · 检查清单