Docsbookが主張を証明する方法
ドキュメントプラットフォームは、「高度な」「インテリジェントな」「最適化された」といった形容詞を伴って販売されます。形容詞は反証できないため、情報を何も伝えません。そこで、このドキュメントは別のルールに従って書かれています。機能ページは、懐疑的なエンジニアが私たちを検証できるものでなければなりません。ある文が「誰がそう言っているのか？」という問いに耐えられないなら、それは公開しません。
このページ自体がそのルールなので、私たちにそれを守らせることができます。
すべての機能ページに含まれる内容#
SEO、GEO、AEO、エージェント対応コンテンツ、AIチャット、アナリティクス、翻訳の各ページには、次の4つのブロックがこの順序で含まれています。
| ブロック | 含めるべき内容 | 確認方法 |
|---|---|---|
| 得られるもの | 利用者にとっての結果 — ページ、パネル、APIに表示されるもの | 自分のサイトを開いて確認する |
| 構築方法 | 実装を読んだ人にしか書けないレベルの仕組み：しきい値、優先順位、フォールバック、失敗時の動作 | 生成されたHTML、APIレスポンス、またはエクスポートされたデータと比較する |
| 根拠 | 各ルールを、ルール → 機械または読者がそのように動作する理由 → 一次ソースへのリンクとして示す | リンクを開く |
| 制限事項 | この機能が行わないこと、測定されないこと、当社が制御できないモデルのバージョンに依存すること | 何か抜け落ちていないかを判断する |
制限事項のブロックがないページはパンフレットであり、パンフレットは信頼を高めるどころか、むしろ信頼を失わせます。
ここでソースとして扱われるもの#
ソースには順位を付けており、その順位は主張の表現に表れます。
- 仕様およびベンダーのドキュメント — Google Search Central、schema.org、W3C、IETF、Model Context Protocolの仕様、llms.txtの仕様、および関係するモデルプロバイダーが公開しているドキュメント。これらのいずれかに基づく主張は、断定的に記載します。
- 方法とサンプルサイズが明記された査読済みまたはプレプリントの研究。 方法を添えて記載します。「10,000件のクエリで測定」とあれば、どの程度信頼できるかが分かります。
- 方法論を公開している独立した調査。 文中で必ず出典を明記します。「Xが測定した」とし、「それは知られている」とは記載しません。
- 自社のものを含む、ベンダーが報告した結果。 ベンダー報告であることを明記します。自社の内部測定値は自社のものとして明記します。
その基準を下回るものは証拠ではなく、掲載されません。
意図的に主張していないこと#
これらはドキュメントベンダーが主張することを期待される内容であり、私たちがそうした主張をしない理由です。
- 引用率の向上はありません。 機能を有効にするだけで、PerplexityやChatGPTがあなたを引用する頻度がN%増えると、誰も誠実に約束することはできません。管理された検証で測定された内容は、マーケティングで語られるものより限定的であり、GEOでは、何が誰によって測定されたのかを正確に説明しています。
- AI回答の正確性に関するパーセンテージはありません。 私たち自身のコーパスを使い、私たち自身の評価担当者が算出した数値は、あなたのコーパスについての証拠にはなりません。AIチャットでは、パイプラインが根拠に基づいた状態を維持するために行っていることと、測定対象を説明しており、スコアを捏造していません。
- ランキングの保証はありません。 検索ランキングは契約ではなく、Google自身のドキュメントにもそう記載されています。SEOでは、Googleが文書化している内容と推論を分けて説明しています。
- 取得していないコンプライアンス状況を主張しません。 MCPセキュリティでは、現在の状況を示し、まだ提供していないものを明記しています。
「要検証」ブロック#
これらのドキュメントにある主張を検証できない場合――仕組みが変更された、出典が引用の根拠となる内容を実際には述べていなかった、または誰も測定結果を公表していない場合――私たちはその文を削除せず、曖昧な表現に弱めることもしません。明示的なブロックにします。
要検証。 主張。 検証可能な内容：検証できる部分。 検証できない内容：検証できない部分とその理由。 測定されるまでは仮説として扱ってください。
このブロックは、私たちのプロセスに関する約束です。裏付けできない主張をひそかに削除するのではなく、あなたが確認できるようにするということです。
これらの主張が真実であり続ける仕組み#
ドキュメントは気づかないうちに製品からかけ離れていきます。これはDocsbookが解決するために存在する失敗モードであり、そのため同じ仕組みがこのドキュメントにも適用されています。
- ユーザー向けの変更にはすべて変更履歴のエントリが付随し、何が変更されたかだけでなく、その変更によって何を実現しようとしたのかが記載されます。
- 変更履歴は成果ごとのページに展開されるため、単なる一覧ではなく、AIによる引用、サポート負荷、オーガニックトラフィックなど、1つの成果の履歴を読むことができます。
- 各ページには、そのページを変更したコミットから取得した最終更新日が表示されるため、古いページが最新であるかのように装うことはできません。GEOを参照してください。
問題を見つけましたか？#
このページの記載が製品の動作と一致していない場合、それは不具合です。そのままにしておくよりも、ぜひお知らせください。
- ページと該当する文を添えて、support@docsbook.io までメールしてください。
- または、Docsbook Discord でお知らせください。