判断内容质量，修订并持续维护

从约定的阅读结果判断质量复制锚点链接

一份文章要支持什么理解、判断或操作，是质量评价的起点。同样一句解释，对熟悉基础的读者可能足够，对首次接触相关对象的读者可能留下关键缺口；一个局部试验可以回应“样本出现什么结果”，却还不能回应“所有场景是否适用”。

质量包含多种性质。准确的材料可能遗漏决定性条件，完整的材料可能推理错误，易读的材料也可能没有回应问题。Diátaxis 将准确、完整、一致和有用等性质分别讨论；这些区别提醒作者沿实际缺陷评价内容。¹

可以从六个相互关联的关注点检查：主要问题是否直接回答；关键事实是否准确并有依据；推理是否可靠；当前范围是否有决定性缺项；目标读者能否沿解释路径理解；成果是否独立且可复核。它们共同支持最终阅读结果，关键错误不能用其他方面的优点抵消。

操作说明的充分性包括必要前提、步骤、结果及相关失败处理；机制解释的充分性包括理解当前关系所需的对象、规则与边界。逐篇判断实际承诺，比要求每篇都有同样栏目更有意义。

让审阅意见指出具体断点复制锚点链接

“逻辑不好”“太长”“不够深入”等反馈还不足以指导修订。有效意见指出具体位置、缺陷、依据，以及它怎样影响主要结果。这样才能判断该返回研究补证、调整知识路径，还是改写表达。

例如，下面是一个构造审阅情境。一篇方法比较文章声称“方案 A 更适合大文档集”，依据却只覆盖一个小样本。审阅意见可以写：“结论将小样本表现推广到大文档集；现有结果没有覆盖规模变化，因此大规模推荐缺少关键依据。需补充相应规模证据，或将结论收窄到已测样本。”这个意见同时说明位置、证据缺口和处理方向。

缺陷影响可以帮助安排修订：

真实缺陷还需逐项判断。例如，未做浏览器观察会限制对页面交互的判断，对单纯说明函数定义的文章未必构成同样的缺口。已知错误则需要修正；笼统写“可能有局限”无法使错误成为可保留事实。

修订沿受影响的关系返回复制锚点链接

写作发现引用不足时，可以返回研究；审阅发现前提缺失时，可以补充必要解释；证据变化使结论失效时，需重新检查建议、例子及相关图表。研究、起草和质量判断由这些关系连接，可以在同一次工作中往返。

一种实用的处理次序是：先确定受影响的主张和阅读结果，再核查造成缺口的原因，完成必要补证或改写，最后检查关联内容是否仍一致。举例来说，上述方案推荐收窄后，正文标题中的“大规模最佳方案”、比较表中的无条件优势和后续部署建议，都可能需要同步调整。

复核投入按实际影响安排。只修改一个明确指代，通常检查该段及承接即可；改变核心前提，就需要回查依赖它的解释和结论。继续在当前范围内处理可解决的重要缺陷，草稿状态只是公开范围的属性。

审阅和验证分别能说明什么复制锚点链接

不同证据能支持不同质量判断：

技术检查通过是必要技术条件的证据，不能同时证明内容准确。案头判断可以发现解释缺口，不能直接声称读者理解正确率已经提高。AHRQ 的 PEMAT 面向患者教育材料，明确其评分不评价准确性或充分性，高分也不能保证适合特定人群；这里借它说明评价工具的覆盖边界，不移植其健康传播评分。²

报告验证时，区分设计意图、实际实现、检查结果、运行观察和推断。配置存在支持实现描述，实际执行支持对应检查结果；教学构造与预期输出也应能识别。本次执行、历史来源记录和没有执行的检查分别报告。

必要信息包括所用版本、输入、环境、判定方式、结果和未覆盖范围。未执行就写未执行；失败就说明失败的位置与性质。保留可重跑材料能够支持后续复核，本次是否重跑成功仍由本次证据说明。

让交付与完成范围相符复制锚点链接

主要问题已得到可靠回答，重要错误和阻断目标的缺项已处理，必要技术检查通过，剩余局限不推翻声称结果时，可以按约定范围完整交付。“完整”依本次承诺成立，仍应说明依据和验证边界。

主要问题仍有决定性未知，或必要技术检查因外部条件无法完成时，可靠部分可能有独立用途。受限交付需要明确已答与未答、限制原因、对采用的影响及需要的新证据。原目标尚未完成的部分继续保留为未完成，不能用“已有用”替代完成判断。

如果内容或实现本身导致检查失败，或存在当前范围内可修正的决定性错误，应继续修订。环境、权限和外部依赖阻断则先完成仍可执行的工作，准确报告剩余阻断。受限交付也需要遵守相应公开流程与检查条件。

原任务若是比较争议并界定未知，无法确认某个效果可能正是可靠答案；原任务若是确认效果，同样的未知通常意味着任务仍受限。交付时重新核对用户问题和正文承诺，能避免悄然降低目标。

维护依赖事实的解释复制锚点链接

内容的有效性随对象、版本、条件和读者问题变化。长期维护从变化触发：接口更新、来源更正、实现迁移、样本扩大、术语调整或读者反馈，都可能使相关解释需要复查。核查日期提供复查线索，不能自动证明之后的状态。

定位发生变化的事实，沿依赖关系检查正文、示例、图表、结论与链接。方法正文归专题、来源比较与实验结果归调研、执行条款归规范时，各部分在自己的用途上维护；迁移内容保留必要证据，并更新原有引用，避免维护多套完整讲解。

历史检查结果仍按原时间和环境保存。重新执行后增加新结果，不把旧样本写成新场景；旧结论失效后，也不能继续作为当前事实使用。必要历史背景可以说明取舍怎样形成，已经失效且无独立用途的重复正文则可以收敛。

维护的重点是恢复受影响的理解与判断，所需证据直接保留在成果或有明确用途的附件中。规范与流程怎样组织这些职责，见规范体系与协作。

Footnotes复制锚点链接

1. Diátaxis，Towards a theory of quality in documentation，Functional quality、Understanding the limits。本文的六个关注点为面向本专题用途的综合，不宣称是该框架的正式评分工具。 ↩

2. AHRQ，The Patient Education Materials Assessment Tool (PEMAT) and User’s Guide — Introduction，What Is the PEMAT?、Are All Materials With High PEMAT Scores High Quality?。 ↩