Repository navigation
Commit c0bff72
committed
docs(standards): 补登历史文档回写的唯一合法形态
依据 = 控制方的**张力裁决(K,常设)**:「本批文档回写的**唯一合法形态 = 「原文 + 就地加注」**;派单里凡出现「删掉 / 移除 / 改成」这类**字面删改**措辞,**一律按「加注作废 / 加注更正」执行**,并在报告里指出该措辞与 V2 的冲突;**不要**为了迁就措辞去破 V2」(控制方已自陈该要求自相矛盾并登记为控制方错误;T21 的处置被登记为**正例**)+ AGENTS.md §6「规范过时时先改规范」。
形态 = **纯追加**(在 `### 第四部分:文档维护节奏` 与 `### 第五部分:CHANGELOG 规范` 之间**新增一个小节**,既有内容一字未改)⇒ 本提交 **+11 行 / −0 行**。
【逐字对照:改了哪一行 / 原文是什么】
- **位点**:`docs/standards/documentation.md`,`### 第五部分:CHANGELOG 规范` 之前。
- **原文(保留,一字未动)**:`### 第五部分:CHANGELOG 规范` 及其全部正文;第四部分正文(文档即代码原则 / 维护触发点 / 定期审查)**同样一字未动**。
- **加注(新增小节)**:`### 第四部分之补 · 历史文档的回写形态:「原文 + 就地加注」是唯一合法形态(常设;2026-09-13 批 7 落账)`,含:
1. **背景**:规格 / 版本记录 / 台账这类**历史文档**承载审计链 —— 旧文本本身就是证据(「当时是怎么写的」决定后来能不能对上账)。
2. 🔴 **唯一合法形态 = 「原文 + 就地加注」**:**不得**字面删除 / 改写历史句;更正以「🔻 …(原文保留)」块表达,使**原文可读、结论唯一**。
3. 🔴 **机器判据 = 「diff 只有 `+` 行、`−` 列为 0」**(`git diff --numstat` 的删除列 + `git diff` 的 `^-` 行数)⇒ 派单里凡出现「**删掉 / 移除 / 改成**」这类字面删改措辞,**一律按「加注作废 / 加注更正」执行**,并在报告里指出该措辞与该判据的冲突;**不要为迁就措辞去破该判据**。
4. 🔴 **「不改历史原文」不能只看 `numstat` 删除列** —— 回写类单元**必须另做「标题 / 锚逐条对拍」**;并**逐字记录本批的那次事故**(首版误删小节标题,`numstat` 当时读作 `+150/−0`,**掩盖**了删除;靠标题对拍自捉)。
5. **数字与结论必须带时点与来源**:同一指标在不同时点的两个读数**都留**(逐字给本批的例子:「上游时点 578 文件 / 295–299 = 20」→「重跑时点 579 / 21」)+ **差额归因**;**不得**只留一个使历史不可复算。
6. **引述纪律**:入库文档里凡转述他人给的数字 / 路径**必须标明来源**;事后证伪 ⇒ **保留错文 + 就地加注更正**,并**登记「错文曾被入库」这一事实**(逐字给本批的例子:控制方的引述错误被抄进入库文档,随后更正)。
- 1 parent 75175a5 commit c0bff72
1 file changed
Lines changed: 11 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
113 | 113 | | |
114 | 114 | | |
115 | 115 | | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
116 | 127 | | |
117 | 128 | | |
118 | 129 | | |
| |||
0 commit comments