引用規律

Spec: ISO/IEC/IEEE 26514Spec: ISO 24495-1

概要

これは、Insider_ の他のページが標準をどう引用するかを説明するときに参照するページです。これらのドキュメントが標準を引用せずにパラフレーズする理由、主張が標準とそれが依拠する正確な条項をどう示すか、そして整った引用が何を約束し、何を約束しないかを正確に説明します。

このページは、主張を信頼する前に、その主張がどのような規則のもとで行われたかを知りたいシニアエンジニアのために書かれています。そう考えるのは当然です。

なぜこれが重要か

他のすべての Insider_ ページは主張を行い、その主張を名前の付いた標準と条項に結び付けます。その引用は、背後にある規律が明示されている場合にのみ価値を持ちます。もし「標準に裏付けられている」が、「仕様を注意深く読んだ」から「だいたいの内容を覚えている」まで何を意味してもよいのなら、その引用は飾りにすぎません。

さらに厳しい制約もあります。NextPDF が準拠する多くのドキュメント（ISO、ETSI、および類似の仕様）はライセンスされています。それらのテキストは、どれほど短くても再現できません。したがって、この規律は 2 つの問題を同時に解決しなければなりません。出典を再現せずに、主張をその出典までたどれるようにすることです。その両方に対する答えは、正確な引用と忠実なパラフレーズであり、このページがその仕様書です。

要約

Insider_ は標準をパラフレーズし、ライセンスされた標準を決して引用しません。 主張は標準と正確な条項を示しますが、標準の言葉を再現することはありません。
パラフレーズは回避策ではなく、理解度のテストです。要件を NextPDF 自身の言葉で言い換えることにより、書き手はそれを理解することを求められ、用語も用語集と一貫します Spec: ISO/IEC/IEEE 26514, §8。
標準に裏付けられたすべての主張は、ドキュメント全体ではなく特定の条項またはセクションを示し、次のレビュアーがその条項を開いてパラフレーズを照合できるようにします。
引用は、それが依拠する出典の種類（条項、エンジンのコード、テスト、測定）を示します。そのため、過剰な主張は一目で分かります。
主張を、書き手が実際に読んだ条項に結び付けられない場合、それは捏造されません。 主張は保持され、未解決としてマークされ、ページは未公開のままになります。これは即興ではなく、文書化されたプロトコルです。

NextPDF のアプローチ

引用ではなくパラフレーズ

NextPDF のスタイル階層における最も厳格な規則は、すべての上流ガイドに優先します。つまり、ライセンスされた標準化団体のテキストを逐語的に掲載することは、抜粋がどれほど短くても禁止されます。代わりに、ページは標準と条項を示し、要件を自身の言葉でパラフレーズします。

これは通常、ライセンス上の制約として説明され、実際そのとおりです。しかし、より有用なのは編集上の観点です。逐語的な引用は、コピーできることしか証明しません。忠実なパラフレーズは、意味を変えずに言い換えられるほど条項を理解していることを証明します。そしてそれは、文章を NextPDF の一貫した語彙にとどめ、ページの途中で文体が切り替わらないようにします。これはドキュメント品質モデルが要求するものです Spec: ISO/IEC/IEEE 26514, §8。平易な言葉は、読み手が内容を見つけ、理解し、使えるかどうかで判断され、文章が出典を反映しているかどうかでは判断されません Spec: ISO 24495-1, §Introduction。パラフレーズはその助けになりますが、引用は助けになりません。

主張はドキュメントだけでなく条項を示す

パラフレーズを検証可能にする仕組みは正確さです。標準に裏付けられたすべての主張は、それが依拠する正確な条項またはセクション（たとえば ISO 32000-2 §6）を示し、ドキュメントだけを示すことはありません。レビュアーは書き手の記憶を信頼する必要はありません。その条項を開いて言い換えと比較します。条項の参照は、引用できない出典と検証可能な主張をつなぐ結合点です。出典のテキストを運ぶことなく、どこを見ればよいかを運びます。

引用はこれがどの種類の出典かを示す

引用は「どこから」に答えます。それは「どの種類か」にも答えなければなりません。ある主張が標準の条項に依拠していると述べることは、エンジン自身のコード、テスト、または測定に依拠していると述べることとは別の約束です。NextPDF は、読み手がそれらを比較考量できるよう、これらの種類を区別して扱います。コードとテストはランタイムの挙動より上、ランタイムはメタデータより上、メタデータは文章より上です。このページのような editorial のページが、コードに裏付けられているふりをすることはありません。

出典の種類	約束すること	約束しないこと
Code-backed	エンジンのソースまたは実行可能な例に対する主張の検証	標準がそれを義務付けていること
Standard-backed	引用・パラフレーズされた条項への主張の固定	コードが現在それを例外なく実装していること
Test-backed	スイート内のテストによるその挙動の保持	性能の数値
Benchmark-backed	明示された方法のもとでの測定によるその数値の裏付け	同じ数値がお使いのハードウェアで得られること
Artifact-backed	生成された成果物（ビルド出力、レポート）による実証	標準による義務付け
設計原則	意図的で論証された設計上の決定	経験的な測定
Editorial	他の材料を整理する、論証された説明	それ自身による新たな挙動の保証
Mixed	複数の根拠を組み合わせ、主張ごとに示すページ	単一の明確な根拠

このページは editorial です。それ自身のエンジン挙動は一切主張しません。他のページの引用が依拠する規律を説明します。それがこのページにとって誠実な根拠であり、そう述べること自体が、この規律を自分自身に適用したものです。

出典を読めない場合

標準へのアクセスは常に即座に得られるとは限りません。ライセンスされた仕様は書き手がこれから入手するものかもしれませんし、条項はその意味が明確になるまで二度目の通読が必要かもしれません。この規律の誠実さは、そのときに何が起きるかに表れます。書き手は推測しません。書き手が実際に読んだ条項にまだ結び付けられない主張は、保持され、リポジトリ内の材料とコード自身が宣言する標準リファレンスに結び付けられ、明示的に未解決とマークされ、条項が正しく引用されるまでページは未公開のままになります。

禁じられた手法は列挙され、チェック可能です。正確に見せかけるために作られた条項番号、記憶から書かれたのに読んだかのように装われた引用、あるいは引用を回避するために主張を黙って削除すること。草稿上の正しくマークされた未完了の引用は、欠陥ではなく、メモを伴う負債です。オフラインの決定論的なチェックが、まさにその区別を強制します。

実践例

この規律は具体的です。それはページの citations フロントマターの構造そのものです。各エントリは主張をその条項に結び付けます。

citations:
  - spec: "ISO 32000-2"
    clause: "§6"
    # 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 自身の言い換えです。spec と clause は、レビュアーがその言い換えを確認するために正確な出典へ戻る手段です。エントリが運ぶのは条項へのポインタであって、条項の言葉ではありません。

よくある誤解

罠は、「引用せずパラフレーズする」を、明言せずに権威ありげに見せるための言い逃れとして読んでしまうことです。それは逆です。引用は何も約束しません。他人の言葉を借りるだけです。引用付きのパラフレーズは、レビュアーが条項に照らして反証できる言い換えに、書き手をコミットさせます。この規律は主張の説明責任を高めます。弱めるものではありません。

2 つ目の罠は、「editorial」を「standard-backed」の弱い等級として扱うことです。それは等級ではまったくなく、異なる種類です。このページのような editorial のページは、他の材料を整理し説明します。それは正しくラベル付けされています。そしてラベルこそが要点です。ページにどれだけの重みを与えるかを決める前に、どのような種類の出典に依拠しているかを伝えるからこそ、このシステムは機能します。

限界と境界

このページは引用の規律を規定します。スタイルシートやゲートコードではありません。正典となる成果物はリポジトリ内にあり（docs/style/nextpdf-overrides.md §5、composer.jsondocs:* スクリプト）、相違があればここの要約より優先されます。それはエンジン挙動を一切主張しません。

この規律は主張を縛るものであり、読み手の結論を縛るものではありません。忠実に引用されたパラフレーズは、条項が何を要求するかを伝えます。NextPDF の解釈があなたの義務に必要なものかどうかは、依然としてあなたの判断です。だからこそ、挙動に関するページは standard-backed だけでなく、コードまたはテストに裏付けられた引用も併せて持ちます。強制は正直に言えば部分的です。オフラインのチェックは稼働しており、逐語引用チェッカーとライブ引用チェッカーは結線されていますが、その網羅的なランナーはまだ完成途上です。完了ではなく、進行中として述べています。

用語集

引用規律 — Insider_ の主張をその出典にどう結び付けるかを規定する規則群。パラフレーズし、正確な条項を示し、ライセンスされた標準を決して引用しない。
パラフレーズ — 要件を NextPDF 自身の、用語集と一貫した言葉で言い換えたもの。引用に代わる理解度のテスト。
条項の参照 — パラフレーズが依拠する正確な条項またはセクション。レビュアーがそれを開いて言い換えを検証できるよう記録される。
標準に裏付けられた主張 — 名前の付いた標準の、引用・パラフレーズされた条項に固定された主張。エンジンのコード、テスト、測定、または編集上の論証に裏付けられた主張とは区別される。
未解決の引用 — 書き手が読んだ条項にまだ結び付けられない主張。捏造される代わりに、保持され、未完了としてマークされ、公開を保留される。