引用纪律
Spec: ISO/IEC/IEEE 26514 ISO/IEC/IEEE 26514 Spec: ISO 24495-1 ISO 24495-1 Evidence: Editorial
Insider_ 的其他页面提到「证据等级」时,指的就是本页。它说明这些文档为什么改写标准而不直接引用标准、一项主张如何链接到你可以重新验证的 reference ID,以及八个证据等级各自到底承诺什么、不承诺什么。
本页面向资深工程师:他们在信任一项主张之前,会先想知道这项主张依据哪些规则得出——这完全合理。
为什么这很重要
标题为“为什么这很重要”的章节Insider_ 的其他每个页面都会提出主张,并给它标注一个证据等级。只有当这个标记背后的系统足够明确时,它才有价值。如果「以标准为依据」可以表示从「我仔细读过规格」到「我大致记得它说过什么」之间的任何含义,那么这个徽章就只是装饰。
此外,还有一项更严格的限制。NextPDF 所依据的许多文档——ISO、ETSI 与类似规格——都是受授权保护的。无论篇幅多短,都不允许重制其中的文本。因此,这套纪律必须同时解决两个问题:让一项主张能够对照其来源接受检验,同时又不重制该来源。这两个问题的答案是同一套机制,而本页就是这套机制的规格说明。
简短版
标题为“简短版”的章节- Insider_ **会改写标准,而且绝不引用受授权保护的标准。**一项主张会引用标准、条款以及一个 reference ID;它不会重制标准原文。
- 改写不是一种权宜之计;它是一项**理解力测试。**以 NextPDF 自己的语气重述一项要求,会迫使撰写者真正理解该要求,并让术语与词汇表保持一致 Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 。
- 每一项以标准为依据的主张,都会在该页的
citations前置数据中,带有一个64 字符的reference_id,让下一位审查者能够重新取回确切的来源段落并核对改写。 - 徽章声明一个证据等级——八种之一——用来说明证明的种类,让过度宣称一眼可见。
- 当来源无法取回时,这项主张**不会被伪造。**它会被保留、相对于一份重新钉选(re-pin)的账本标记为未解决,而该页则保持未发布——这是一套有文档记录的协议,而不是临场发挥。
NextPDF 如何处理这件事
标题为“NextPDF 如何处理这件事”的章节改写,而非引用
标题为“改写,而非引用”的章节NextPDF 风格层级中最严格的规则优先于所有上游指南:不得出现来自受授权标准机构的逐字文本,无论这段摘录有多短。取而代之,页面会引用标准与条款、以自己的语气改写该要求,并记录来源的 reference ID。
这通常被视为一项授权限制,而事实也是如此。但从编辑角度看,这种理解更有用。逐字引用只能证明你会复制。忠实的改写则证明你充分理解该条款,能够在不改变其含义的前提下重述它。而且,它能让句子留在 NextPDF 一致的词汇体系中,而不是在页面中途切换语域,这正是文档质量模型所要求的 Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 。浅白语言的评判标准在于读者能否找到、理解并运用这些内容,而不在于行文是否与来源逐句对应 Spec: ISO 24495-1, §Introduction ISO 24495-1 §Introduction ; 改写能做到这一点,引用做不到。
一项主张链接的是 reference ID,而不是记忆
标题为“一项主张链接的是 reference ID,而不是记忆”的章节让改写能够接受检验的机制,就是 reference ID。每一项以标准为依据的主张,都会在该页的 citations 前置数据中,带有一个完整 64 字符的 reference_id,用以标识改写所依据的确切来源段落。审查者不必信任撰写者的记忆;他们会重新取回该段落并进行核对。reference ID 是无法引用的来源与可验证主张之间的连接点。它承载的是证明位于何处,却不承载证明的原文。
证据等级陈述这是何种证明
标题为“证据等级陈述这是何种证明”的章节引用回答的是「来自何处」。证据等级回答的是「属于哪种证明」。每一个 Insider_ 页面都会声明一个证据等级,显示在徽章列中,并取自一组固定的八种之一。信任顺序将代码与测试排在运行阶段之上、运行阶段排在中继数据之上、中继数据排在叙述文本之上;编辑类页面不会佯装自己是以代码为依据的。
| 证据等级 | 它承诺什么 | 它并不承诺什么 |
|---|---|---|
| Evidence: Code-backed | 此主张会对照引擎的源代码或一个可运行的示例加以检验 | 某项标准强制要求它 |
| Evidence: Standard-backed | 此主张锚定于一条经引用、改写并带有 reference ID 的条款 | 代码目前毫无例外地实现了它 |
| Evidence: Test-backed | 测试套件中有一项测试将此行为固定下来 | 某个性能数字 |
| Evidence: Benchmark-backed | 一项按明确方法进行的测量支持该数字 | 在你的硬件上得到相同的数字 |
| Evidence: Artifact-backed | 一个生成的产物(一份构建输出、一份报告)展示了它 | 某项标准的强制要求 |
| Evidence: Design principle | 一项刻意且经过论证的设计决策 | 一项实证测量 |
| Evidence: Editorial | 一段有理有据、用以组织其他证据的说明 | 它自身就是一项全新的行为保证 |
| Evidence: Mixed evidence | 该页混合了多种依据,并逐项说明分别是哪些 | 单一且清晰的依据 |
本页为 Evidence: Editorial :它不声明任何自身独有的引擎行为。它说明的是其他页面徽章所依赖的这套系统。对它来说,这是诚实的等级;明确这一点,正是将这套纪律施用于自身。
当来源无法取回时
标题为“当来源无法取回时”的章节取回并不总是可行。这套纪律的严谨性,恰恰体现在这种时候会发生什么。正常的队列、速率限制或预算暂停并非服务中断。撰写者会等待。一次真正的服务中断会触发一套有文档记录的后备机制:此主张会被保留、附上存储库内的证据以及代码本身所声明的标准参照、相对于一份常设的重新钉选账本被明确标记为未解决,而该页则保持未发布,直到 reference ID 真正被钉选为止。
被禁止的动作会被逐一列明并可检查:伪造一个 reference ID、填补或添加前缀数值让它看起来像真的、凭记忆写出一条条款并伪装成已取回的引用,或为了规避引用而悄悄删除该主张。草稿上一次被正确标记的服务中断,是带有账本记录的债务,而不是缺陷。一项脱机、确定性的检查,正是用来强制执行这一区分。
证据怎么说
标题为“证据怎么说”的章节本页为 Evidence: Editorial ,因此它自身的依据,是本存储库中的文档治理规范,以及为这套纪律提供正当性的那些标准。此处的主张有两种验证方式:阅读存储库内的规则,以及重新取回所引用的条款。
| 主张 | 依据 | 锚点 |
|---|---|---|
| 改写迫使人理解 | 标准 | 浅白语言以读者的使用情况来评判,而非看它是否与来源逐句对应 Spec: ISO 24495-1, §Introduction ISO 24495-1 §Introduction |
| 术语保持一致 | 标准 | 每个术语都在整份文档中一致地使用 Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 |
| 审查是流程的一部分 | 标准 | 在开发过程中进行验证与确认测试 Spec: ISO/IEC/IEEE 26513, §Foreword ISO/IEC/IEEE 26513 §Foreword |
| 证据等级可优先被识别出来 | 标准 | 识别优先于回想 Spec: ISO 9241-110, §5.6.2 ISO 9241-110 §5.6.2 |
| 无逐字的受授权文本;已钉选参照 | 存储库内 | docs/style/nextpdf-overrides.md §5;composer docs:jaccard-fingerprint |
| 服务中断后备是一套真实的协议 | 存储库内 | 具规范性的 RAG 后备治理,以及脱机的 docs:rag-fallback-check 关卡 |
实际范例
标题为“实际范例”的章节这套纪律很具体:它就是一个页面 citations 前置数据的结构。每一笔条目都是一项主张的收据。
citations: - spec: "ISO 32000-2" clause: "§6" # full 64-char reference ID — the join to the source span, re-verifiable reference_id: "<64-hex digest>" # NextPDF-worded topic — the paraphrase, never the standard's text topic: "A writer's created or amended PDF elements must conform and stay consistent"按设计,这里没有 quote 字段。topic 是 NextPDF 自己的重述。reference_id 则是审查者得以回到确切来源、核查那段重述的方式。这份收据承载的是指向证明的指针,而非证明的原文。
常见的误解
标题为“常见的误解”的章节陷阱在于把「改写、不要引用」理解成一种含糊其词的做法——一种不作承诺却听起来很权威的方式。事实恰恰相反。引用本身不承诺任何东西;它借用的是别人的文本。一段带有引用锚点的改写,则让撰写者对一段重述做出承诺,而审查者可以对照来源加以证伪。这套纪律让主张更需要负责,而不是更少。
第二个陷阱,是把「编辑类」当成「以标准为依据」的较弱等级。它根本不是一个等级;它是一种不同的种类。像本页这样的编辑类页面,组织并说明其他证据。它被正确地标示了。而这个标示正是重点所在:这套系统之所以运作,是因为一个页面会在你决定要赋予它多少权重之前,先告诉你它所提供的是哪种证明。
限制与边界
标题为“限制与边界”的章节本页规范的是引用纪律;它不是样式表、不是后备治理,也不是关卡代码。具权威性的产物都在存储库内(docs/style/nextpdf-overrides.md §5、具规范性的 RAG 后备治理、composer.jsondocs:* 指令稿),若有分歧,它们优先于此处的任何摘要。本页不主张任何引擎行为。
这套纪律约束的是主张,而不是读者的结论。一段带有忠实引用依据的改写,会告诉你某条款要求什么。NextPDF 的解读是否正是你的义务所需,仍然由你决定;这也正是为什么涉及行为的页面也会带有以代码或测试为依据的证据,而不是仅以标准为依据。坦诚地说,强制执行仍是部分性的:脱机后备检查已上线,而逐字引用与即时引用的验证器虽已接好,其完整的运行器仍在完成中——这被陈述为进行中,而不是已完成。
相关文档
标题为“相关文档”的章节- 文档即产品——这套引用系统所属的更广泛质量纪律。
- 标准全景——这些引用所指向的标准,以及一条条款如何成为有文档记录的行为。
- NextPDF 测试金字塔——当一个页面宣称的是以测试为依据的等级而非本页这个等级时,这意味着什么。
词汇表
标题为“词汇表”的章节- 引用纪律——一套规则,规范一项 Insider_ 主张如何链接到其来源:改写、引用条款、钉选一个 reference ID,绝不引用受授权保护的标准。
- 改写——以 NextPDF 自己的、与词汇表一致的语气重述一项要求;这是取代引用的理解力测试。
reference_id——一个完整 64 字符的完整性指针,指向某段改写所依据的确切来源段落,并予以记录,让审查者能够重新取回并验证它。- 证据等级——一个页面的主张背后所声明的证明种类,为八种之一(以代码、标准、测试、基准、产物为依据,以及设计原则、编辑类、混合),显示在徽章列中。
- 未解决的引用——一项主张,其 reference ID 因一次真正的取回服务中断而无法钉选;它会被保留、相对于一份重新钉选账本标记,并暂不发布,而不是被伪造。