引用規律
Spec: ISO/IEC/IEEE 26514 ISO/IEC/IEEE 26514 Spec: ISO 24495-1 ISO 24495-1 Evidence: Editorial
これは、Insider_ の他のページが「エビデンスレベル」と述べるときに参照するページです。これらのドキュメントが標準を引用せずにパラフレーズする理由、主張が再検証可能なリファレンス ID にどう結び付くか、そして 8 つのエビデンスレベルそれぞれが何を約束し、何を約束しないかを正確に説明します。
このページは、主張を信頼する前に、その主張がどのような規則のもとで行われたかを知りたいシニアエンジニアのために書かれています。そう考えるのは当然です。
なぜこれが重要か
「なぜこれが重要か」という見出しのセクション他のすべての Insider_ ページは主張を行い、その主張にエビデンスレベルを付与します。その付与は、背後にあるシステムが明示されている場合にのみ価値を持ちます。もし「標準に裏付けられている」が、「仕様を注意深く読んだ」から「だいたいの内容を覚えている」まで何を意味してもよいのなら、そのバッジは飾りにすぎません。
さらに厳しい制約もあります。NextPDF が準拠する多くのドキュメント(ISO、ETSI、および類似の仕様)はライセンスされています。それらのテキストは、どれほど短くても再現できません。したがって、この規律は 2 つの問題を同時に解決しなければなりません。出典を再現せずに、主張をその出典に対して検証可能にすることです。その両方に対する答えは同じ仕組みであり、このページがその仕様書です。
- Insider_ は標準をパラフレーズし、ライセンスされた標準を決して引用しません。 主張は標準、条項、そしてリファレンス ID を示しますが、標準の言葉を再現することはありません。
- パラフレーズは回避策ではなく、理解度のテストです。要件を NextPDF 自身の言葉で言い換えることにより、書き手はそれを理解することを求められ、用語も用語集と一貫します Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 。
- 標準に裏付けられたすべての主張は、ページの
citationsフロントマターに64 文字のreference_idを持ち、次のレビュアーが正確な出典スパンを再取得してパラフレーズを確認できるようにします。 - バッジはエビデンスレベル(8 種類のいずれか)を宣言し、証明の種類を示します。そのため、過剰な主張は一目で分かります。
- 出典を取得できない場合、主張は捏造されません。 主張は保持され、再ピン留め台帳に対して未解決としてマークされ、ページは未公開のままになります。これは即興ではなく、文書化されたプロトコルです。
NextPDF のアプローチ
「NextPDF のアプローチ」という見出しのセクション引用ではなくパラフレーズ
「引用ではなくパラフレーズ」という見出しのセクションNextPDF のスタイル階層における最も厳格な規則は、すべての上流ガイドに優先します。つまり、ライセンスされた標準化団体のテキストを逐語的に掲載することは、抜粋がどれほど短くても禁止されます。代わりに、ページは標準と条項を示し、要件を自身の言葉でパラフレーズし、出典のリファレンス ID を記録します。
これは通常、ライセンス上の制約として説明され、実際そのとおりです。しかし、より有用なのは編集上の観点です。逐語的な引用は、コピーできることしか証明しません。忠実なパラフレーズは、意味を変えずに言い換えられるほど条項を理解していることを証明します。そしてそれは、文章を NextPDF の一貫した語彙にとどめ、ページの途中で文体が切り替わらないようにします。これはドキュメント品質モデルが要求するものです Spec: ISO/IEC/IEEE 26514, §8 ISO/IEC/IEEE 26514 §8 。平易な言葉は、 読み手が内容を見つけ、理解し、使えるかどうかで判断され、文章が出典を反映しているかどうかでは判断されません Spec: ISO 24495-1, §Introduction ISO 24495-1 §Introduction 。 パラフレーズはその助けになりますが、引用は助けになりません。
主張は記憶ではなくリファレンス ID に結び付く
「主張は記憶ではなくリファレンス ID に結び付く」という見出しのセクションパラフレーズを検証可能にする仕組みがリファレンス ID です。標準に裏付けられたすべての主張は、ページの citations フロントマターに完全な 64 文字の reference_id を持ち、パラフレーズの元になった正確な出典スパンを特定します。レビュアーは書き手の記憶を信頼する必要はありません。そのスパンを再取得して比較します。リファレンス ID は、引用できない出典と検証可能な主張をつなぐ結合点です。証明のテキストを運ぶことなく、証明がどこにあるかを運びます。
エビデンスレベルは証明の種類を示す
「エビデンスレベルは証明の種類を示す」という見出しのセクション引用は「どこから」に答えます。エビデンスレベルは「どの種類か」に答えます。すべての Insider_ ページは 1 つを宣言し、バッジ行に表示し、8 つの固定セットから選びます。信頼の順位は、コードとテストをランタイムより上、ランタイムをメタデータより上、メタデータを文章より上に置きます。編集上のページが、コードに裏付けられているふりをすることはありません。
| エビデンスレベル | 約束すること | 約束しないこと |
|---|---|---|
| Evidence: Code-backed | エンジンのソースまたは実行可能な例に対する主張の検証 | 標準がそれを義務付けていること |
| Evidence: Standard-backed | リファレンス ID を伴う、引用・パラフレーズされた条項への主張の固定 | コードが現在それを例外なく実装していること |
| Evidence: Test-backed | スイート内のテストによるその挙動の保持 | 性能の数値 |
| Evidence: Benchmark-backed | 明示された方法のもとでの測定によるその数値の裏付け | 同じ数値がお使いのハードウェアで得られること |
| Evidence: Artifact-backed | 生成された成果物(ビルド出力、レポート)による実証 | 標準による義務付け |
| Evidence: Design principle | 意図的で論証された設計上の決定 | 経験的な測定 |
| Evidence: Editorial | 他のエビデンスを整理する、論証された説明 | それ自身による新たな挙動の保証 |
| Evidence: Mixed evidence | 複数の根拠を組み合わせ、主張ごとに示すページ | 単一の明確な根拠 |
このページは Evidence: Editorial です。それ自身のエンジン挙動は一切主張しません。他のページのバッジが依拠するシステムを説明します。それがこのページにとって誠実なレベルであり、そう述べること自体が、この規律を自分自身に適用したものです。
出典を取得できない場合
「出典を取得できない場合」という見出しのセクション取得は常に利用できるとは限りません。この規律の誠実さは、そのときに何が起きるかに表れます。通常のキュー、レート制限、または予算による一時停止は、障害ではありません。書き手は待ちます。本当の障害では、文書化されたフォールバックが発動します。主張は保持され、リポジトリ内のエビデンスとコード自身が宣言する標準リファレンスに結び付けられ、常設の再ピン留め台帳に対して明示的に未解決とマークされ、リファレンス ID が実際にピン留めされるまでページは未公開のままになります。
禁じられた手法は列挙され、チェック可能です。捏造されたリファレンス ID、本物に見せかけるために水増しまたは接頭辞を付けた値、記憶から書かれて取得済みの引用に見せかけた条項、あるいは引用を回避するために主張を黙って削除すること。草稿上の正しくマークされた障害は、欠陥ではなく、台帳エントリを伴う負債です。オフラインの決定論的なチェックが、まさにその区別を強制します。
エビデンスが示すこと
「エビデンスが示すこと」という見出しのセクションこのページは Evidence: Editorial であるため、それ自身の根拠は、このリポジトリのドキュメントガバナンスと、この規律を正当化する標準です。ここでの主張は 2 通りの方法で検証できます。リポジトリ内の規則を読むことと、引用された条項を再取得することです。
| 主張 | 根拠 | アンカー |
|---|---|---|
| パラフレーズは理解を強いる | 標準 | 平易な言葉は出典の反映ではなく、読み手が使えるかどうかで判断される 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 は、レビュアーがその言い換えを確認するために正確な出典へ戻る手段です。レシートが運ぶのは証明へのポインタであって、証明の言葉ではありません。
よくある誤解
「よくある誤解」という見出しのセクション罠は、「引用せずパラフレーズする」を、明言せずに権威ありげに見せるための言い逃れとして読んでしまうことです。それは逆です。引用は何も約束しません。他人の言葉を借りるだけです。引用付きのパラフレーズは、レビュアーが出典に照らして反証できる言い換えに、書き手をコミットさせます。この規律は主張の説明責任を高めます。弱めるものではありません。
2 つ目の罠は、「editorial」を「standard-backed」の弱い等級として扱うことです。それは等級ではまったくなく、異なる種類です。このページのような editorial のページは、他のエビデンスを整理し説明します。それは正しくラベル付けされています。そしてラベルこそが要点です。ページにどれだけの重みを与えるかを決める前に、どのような種類の証明を提供しているかを伝えるからこそ、このシステムは機能します。
限界と境界
「限界と境界」という見出しのセクションこのページは引用の規律を規定します。スタイルシート、フォールバックガバナンス、またはゲートコードではありません。正典となる成果物はリポジトリ内にあり(docs/style/nextpdf-overrides.md §5、規範的な RAG フォールバックガバナンス、composer.jsondocs:* スクリプト)、相違があればここの要約より優先されます。それはエンジン挙動を一切主張しません。
この規律は主張を縛るものであり、読み手の結論を縛るものではありません。忠実に引用されたパラフレーズは、条項が何を要求するかを伝えます。NextPDF の解釈があなたの義務に必要なものかどうかは、依然としてあなたの判断です。だからこそ、挙動に関するページは standard-backed だけでなく、コードまたはテストに裏付けられたエビデンスも併せて持ちます。強制は正直に言えば部分的です。オフラインのフォールバックチェックは稼働しており、逐語引用チェッカーとライブ引用チェッカーは結線されていますが、その網羅的なランナーはまだ完成途上です。完了ではなく、進行中として述べています。
関連ドキュメント
「関連ドキュメント」という見出しのセクション- 製品としてのドキュメント — この引用システムを含む、より広い品質規律。
- 標準の全体像 — これらの引用が指し示す標準と、条項がどのように文書化された挙動になるか。
- NextPDF のテストピラミッド — ページがこのレベルではなく test-backed のレベルを主張するとき、それが何を意味するか。
- 引用規律 — Insider_ の主張をその出典にどう結び付けるかを規定する規則群。パラフレーズし、条項を示し、リファレンス ID をピン留めし、ライセンスされた標準を決して引用しない。
- パラフレーズ — 要件を NextPDF 自身の、用語集と一貫した言葉で言い換えたもの。引用に代わる理解度のテスト。
reference_id— パラフレーズの元になった正確な出典スパンを指す完全な 64 文字の整合性ポインタ。レビュアーが再取得して検証できるよう記録される。- エビデンスレベル — ページの主張の背後にある、宣言された証明の種類。8 つのうちの 1 つ(code-、standard-、test-、benchmark-、artifact-backed、design-principle、editorial、mixed)で、バッジ行に表示される。
- 未解決の引用 — 本当の取得障害のためにリファレンス ID をピン留めできなかった主張。捏造される代わりに、保持され、再ピン留め台帳に対してマークされ、公開を保留される。