ガバナンスアーティファクト
このページが対象とするガバナンスファイル
このページは、アイデンティティ、優先順位、限界、コーパスの読解条件を宣言する公開サーフェスに結びついています。以下の順序が、推奨される読解の順序です。
Q-Metrics JSON
/.well-known/q-metrics.json
ギャップ、スナップショット、比較を観測するための記述的指標のサーフェス。
- 統御する対象
- ギャップ、ドリフト、スナップショット、比較の記述。
- 画定する範囲
- 観測されたシグナル、忠実性の証明、実際の舵取りの混同。
保証しないこと: 観測サーフェスは効果を記録するものであり、それ単独では表現を保証しない。
Q-Metrics YAML
/.well-known/q-metrics.yml
計装と構造化された読解のための、Q-MetricsのYAML投影。
- 統御する対象
- ギャップ、ドリフト、スナップショット、比較の記述。
- 画定する範囲
- 観測されたシグナル、忠実性の証明、実際の舵取りの混同。
保証しないこと: 観測サーフェスは効果を記録するものであり、それ単独では表現を保証しない。
Q-Ledger JSON
/.well-known/q-ledger.json
観測、ベースライン、バージョン管理されたギャップを記録するマシンファーストのジャーナル。
- 統御する対象
- ギャップ、ドリフト、スナップショット、比較の記述。
- 画定する範囲
- 観測されたシグナル、忠実性の証明、実際の舵取りの混同。
保証しないこと: 観測サーフェスは効果を記録するものであり、それ単独では表現を保証しない。
補完的なアーティファクト(3)
これらのサーフェスは主要ブロックを補完します。テーマに応じて、文脈、発見、ルーティング、観察を加えます。
Q-Ledger YAML
/.well-known/q-ledger.yml
手続き的な読解またはツール利用のための、Q-LedgerジャーナルのYAML投影。
EACレジストリ
/.well-known/eac-registry.json
オープンウェブにおける外部の権威の適格性に関する規範的レジストリ。
適格な外因的主張
/eac-claims.json
受理可能な外因的主張のファミリーの境界を定めるサーフェス。
比較事例集と範例となる矛盾
すべての矛盾が同じドクトリン上の地位に値するわけではない。単なる文書上のノイズにすぎないものもある。これに対して、ある仕組み全体を凝縮している矛盾もある。管轄の衝突、バージョンの遅れ、翻訳による希薄化、第三者サーフェスの支配、説明のソースと決定のソースの逆転、あるいは本来決定的であり続けるべきだった例外の消失である。
比較事例集は、この第二の種類の矛盾を扱うために存在する。それは二つの資料を並べるだけのものではない。複数の状態、複数のソース、または複数の復元を、範例となる衝突の周囲に組織する。範例となる衝突とは、一つのレジーム全体を照らし出せるほど十分に再構成された衝突のことである。
本ページは、ドクトリン上の判例、公開ベンチマーク、応用的な可観測性を発展させるものである。本ページは一つの単純なルールを定める。比較が有用であるのは、公開された矛盾が表面的な不一致以上のものを明らかにする場合に限られる。
1. 矛盾が範例となるとき
矛盾が範例となるのは、単一の事例集によって、ある裁定の構造が見えるようになるときである。
重要なのは、二つの異なる表現が存在するという事実だけではない。重要なのは、次のことを再構成できることである。
- 誰が語っているのか
- どのソースクラスから語っているのか
- どのバージョン状態から語っているのか
- どの管轄、言語、またはサーフェスに向けて語っているのか
- そして、一方の言明が他方に優先した場合にどのような実務上の帰結が生じるのか
したがって、矛盾が範例となるのは、それを提示することでノイズが減り、レジームの理解可能性が高まるときである。その価値は意外性から生まれるのではない。明確化する力から生まれる。
2. 比較事例集が単なるキャプチャに付け加えるもの
単独のキャプチャは、一つの表現を固定する。比較事例集は、相違の空間を可視化する。
比較事例集は、次のものを集めることができる。
- 同じソースの、異なる日付の二つのバージョン
- 完全には一致しないフランス語版と英語版
- 正規ページと、支配的な外因的サーフェス
- 製品ドキュメントとヘルプセンター
- 一つのソーステキストと、複数の合成的な復元
- 一般ルールと、その手続き上の例外
したがって、比較事例集は証拠のギャラリーではない。それは資料を組織的に緊張関係に置くことであり、その比較によって、階層、断絶、例外、あるいは帰属の失敗が見えるようになる。
3. 特に有用な4つの比較軸
a) 同じ対象、異なる時点
ここでは、事例集は真実の移動を示す。以前の状態と現在の状態、告知と変更履歴、旧ポリシーと実際に有効なポリシーである。これはバージョン支配力の本来の領域である。
b) 同じ対象、異なる言語
ここでは、事例集は多言語コーパスの非対称性を可視化する。遅れ、脱落、過剰翻訳、あるいはバージョン間の暗黙の階層である。
c) 同じ対象、異なるソースクラス
ここでは、問題は必ずしも明示的なテキスト上の矛盾から生じるわけではない。FAQ、記事、掲載情報、サポートの回答が、コーパスが実際には与えていない権威をもって語っていることから生じる。これは製品ソース階層と第三者プラットフォームの領域である。
d) 同じ対象、異なる復元
ここでは、事例集は、正規ソースが認めていることと、合成サーフェスがそれをどう扱っているかを比較する。これは特に、メディアや、引用または非回答が残るべき領域で有用である。
4. 良い事例集が可視化しなければならないもの
良い比較事例集は、読み手が調査を一人で再構成しなくても、次の5つの問いに答えられるようにするべきである。
- 正確な矛盾は何か?
- ここではどのソース階層が適用されるか?
- どの資料が拠り所となるべきか、そしてその理由は?
- この矛盾は、検討対象のレジームについて何を明らかにするか?
- 何が未解決のまま、異議申立て可能なまま、または保留のまま残るか?
言い換えれば、比較事例集の役割は、相容れない資料を並べて見せることだけではない。それらの資料をデフォルトで等価なものとして扱うことを防ぐドクトリン上の道筋を示さなければならない。
ここにおいて、権威の衝突と解釈トレースは抽象的なものではなくなる。事例集は、それらを単なるプレイブックに変えることなく、実際に機能するものにする。
5. 範例となる矛盾が「派手な」事例よりも重要である理由
弱い実践では、最も衝撃的なものが公開される。強い実践では、最もよく明確化するものが公開される。
派手な矛盾であっても、階層、バージョンの境界、例外、非回答の条件を再構成させないのであれば、ドクトリン上は貧弱なものになり得る。逆に、一見地味な矛盾であっても、信頼できるソースがなぜ優先されるべきではなかったのか、あるいは個別には正しい二つの表現がなぜ集約されると誤解を招くものになるのかを示すのであれば、きわめて豊かなものになり得る。
したがって、範例となる矛盾は「バイラルな事例」よりも望ましい。それは単なる気まずさではなく、仕組みを可視化するからである。
6. 比較事例集、ベンチマーク、テストケース
比較事例集は、中間的な位置を占める。
比較事例集は、単独の観察よりも構造化されている。公開ベンチマークよりも抽象度が低い。また、形式化されたテストケースと最小限の解釈フィクスチャの準備にもなる。良い事例集は、衝突を再利用可能にするためにどの要素を固定しなければならないか(正規ソース、競合するソース、バージョン状態、例外、期待される出力、正当な保留の形式)をしばしば明らかにするからである。
比較事例集は、しばしば個別の事例と公開可能なテストとの間の過渡的な形式である。
それはまた、公開後のコーパスのガバナンスを最初に迫る対象の一つでもある。事例集が訂正、撤回、または差し替えられたとたんに、その資料、アーカイブされた状態、あり得る後継との関係を明示しなければならない。そうしなければ、比較事例集はトレースとして存在し続けるが、その位置づけは不十分なままとなり、境界を画定しにくい存続する権威を育ててしまう。
7. 範囲と限界
本ページは、矛盾を劇的に扱うことも、相違する事例を際限なく収集することも推奨しない。本ページが定めるのは、より抑制された要件である。矛盾を公開するときには、単に証明らしい効果を生むのではなく、レジームを照らし出せるほど十分に再構成しなければならない。
適切に境界づけられた比較事例集は、「これらのソースは互いに矛盾している」と述べるだけではない。この矛盾がなぜ重要なのか、どの階層を作動させるのか、そしてそこから実際にどこまで一般化できるのかを述べるのである。