38 lines
1.3 KiB
Markdown
38 lines
1.3 KiB
Markdown
# DOC-024 用读者任务验收文档
|
|
|
|
分类:协作与质量。级别:核心。本规则是项目写作约定,不是语言语义。
|
|
|
|
## 规则
|
|
|
|
除结构检查外,按冷读、定位和结果预测任务检查文档。
|
|
|
|
## 原因
|
|
|
|
文件无格式错误不表示读者已经能够理解或使用它。
|
|
|
|
## 执行方法
|
|
|
|
1. 冷读:不查看聊天,复述用途、概念关系和一个核心例子。
|
|
2. 定位:只从目录或术语索引寻找指定规则;记录卡住的地方。
|
|
3. 预测:根据例子解释结果、合法边界与提案状态;将人工评审与真实用户测试分别记录。
|
|
|
|
## 改写对照
|
|
|
|
问题写法:139 个链接通过,所以文档一定易懂。
|
|
|
|
推荐做法:链接检查通过后,再检查读者能否区分归属与引用并预测 90 和 85。
|
|
|
|
以上是说明写作差异的项目例子,不新增语言能力。
|
|
|
|
## 验收
|
|
|
|
- [ ] 验收任务与页面目标对应。
|
|
- [ ] 发现的理解障碍有具体位置。
|
|
- [ ] 没有把作者自查冒充真实用户测试。
|
|
|
|
## 依据与边界
|
|
|
|
[SRC-15](../research/SRC-15.md)。来源页记录观察与分析,本页的执行方法是针对项目的综合建议,不宣称由某一原文逐项规定。
|
|
|
|
[规则索引](../README.md#规则索引) · [检查清单](../checklist.md)
|