Files

1.6 KiB

DOC-021 每次改动完成影响检查

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

规则

文档修改同时检查关联定义、示例、导航与状态,不以改完当前文件作为结束。

原因

局部正确不代表整套文档一致,尤其是同一写法在多个位置出现时。

执行方法

  1. 修改前找出主定义和引用位置,编辑后复查影响范围。
  2. 人工核对链接、锚点、代码块、编号和格式;按风险检查例子与计算。程序检查仅在用户明确要求执行时运行。
  3. 报告实际检查等级、未执行步骤与失败;工具通过不等于语言运行验证。

改写对照

问题写法:修改 use 示例后只检查当前段落。

推荐做法:同步正文、文法、索引和所有相关示例,并记录验证范围。

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

验收

  • 相关引用无过时版本。
  • 命令和结果可复现。
  • 报告没有把静态检查称为编译或运行测试。

具体应用

根据本次断言与对象列出影响页,搜索词形和近义主张。修正后从主定义、文法、状态与例子双向核对,并记录相关读者任务的实际结果。

详见影响范围与工作记录。

依据与边界

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

规则索引 · 检查清单