今すぐ Confluence を開き、読む必要のあるドキュメントを見つけてください。何が見えますか?
ツールバー。編集ボタン。コメントボックスページ履歴リンク。必要のないナビゲーションでいっぱいのサイドバー。パンくずメタデータフィールドパーミッション表示オーサリングインターフェース全体が、あなたが読むためにここに来たテキストを包み込みます。
質問の答え、プロセスの次の3つのステップ、10分後の会議の前に参照する必要のあるポリシーなどです。
あなたは消費するために来たのです。インターフェイスは、あなたが創造するために来たと仮定しています。
これは、ほとんどすべてのドキュメントプラットフォームのデフォルトです。Confluence、Notion、SharePoint、GitBook、Nuclino、Slite。これらはすべて、読み手と書き手に同じ環境を提示しています。ページはページです。いくつかのパーミッションゲートボタンの有無にかかわらず、誰もが同じビューを得られます。
それが普通だと感じるのは、他に何もなかったからです。しかし、それはデザイン上の決定であって、自然の法則ではありません。そして、それは間違ったものなのです。
読むのも書くのも同じインターフェースは認知的なオーバーヘッドを生む](/ja/blog/img/readers-writers-ui.svg)
読み書きは同じ認知作業ではありません
これはUIの好みではありません。脳の働き方の根本的な違いです。
文章を書くときは、生成モードです。構成し、整理し、何を盛り込み、何を省くかを決めているのです。フォーマットオプション、構造コントロール、メディア埋め込み、メタデータフィールド、バージョン履歴、コラボレーション機能といったツールが必要です。インターフェースは、あなたにパワーと柔軟性を与えるものでなければなりません。
読むときは、受容モードです。スキャンし、フィルタリングし、関連するものを抽出し、次に進もうとしています。必要なのは明快さです。すっきりとしたタイポグラフィ、焦点を絞ったレイアウト、邪魔になるものの最小化。インターフェースは邪魔にならないものでなければなりません。
認知心理学には、このための明確なフレームワークがあります。1980年代後半にJohn Swellerによって開発されたCognitive Load Theoryでは、本質的負荷（教材自体の難易度）、本質的負荷（学習と統合の努力）、外在的負荷（役に立たない環境が加えるものすべて）を区別しています。読者に見えるすべてのツールバー、サイドバー、編集ボタンは余計な負荷です。コンテンツを理解する助けにはなりません。それは積極的に注意を引くために競合します。
マルチメディア学習に関する[Mayer and Moreno (2003)] (https://doi.org/10.1207/S15326985EP3801_6)の研究では、余計な要素を減らすと、理解も定着も向上することが実証されています。彼らの一貫性の原則は直接的です：オーサリングのコントロールを読者に見せるドキュメンテーションのインターフェースは、すべてのページロードにおいてこの原則に違反しています。
**読者はライターのツールを見る必要はありません。とにかく見せることは中立ではありません。それは理解に対して積極的に有害です。
現在のプラットフォームはこれをどう扱うか(ほとんど扱いません)
存在するものを見てみましょう。
Confluenceには閲覧モードと編集モードがありますが、閲覧モードはプラットフォームのナビゲーション、メタデータ、ページツリーに囲まれています。編集ツールバーは編集していないときには消えますが、"これは編集可能なウィキのページである "という精神的なフレームは完全に消えることはありません。すべての読者は「編集」ボタンを目にします。ページはささやきます：あなたはこれを変更することができます。
この点では、Notionの方がひどいです。この点で、Notionはもっとひどい。その中心的なデザイン哲学は、すべてが常に編集可能であるということです。どこをクリックしても入力中。それはライターにとっては素晴らしいことです。誤って何かを修正する不安なしにコンテンツを吸収したい読者にとっては最悪です。Notion自身のテンプレートギャラリーを見ればわかります。すべてのテンプレートはワークスペースであり、出版物ではありません。
SharePointは技術的には閲覧用と編集用の異なるページレイアウトをサポートしていますが、全体的な体験は依然として企業イントラネットです。読者は、理解するために最適化されたドキュメントを読んでいるのではなく、企業ツールの中にいるように感じます。
GitBookは、そのクリーンなドキュメンテーションスタイルの出力により、リーディングファーストの体験に最も近いものとなっています。しかし、そこでも読者体験は、読者が技術文書を見ている開発者であるという前提で提供されています。一般的な知識消費者のために設計されているわけではありません。
これらのプラットフォームはいずれも、読むことを書くこととは根本的に異なる行為として扱っていません。ツールバーを隠して文章を書くのと同じ扱いなのです。
現在のツール：1つのインターフェイス、すべての読者](/ja/blog/img/readers-writers-current-tools.svg)
##単一のインターフェースのコスト
これは単なる美学の問題ではありません。測定可能な結果をもたらします。
情報過多による理解力の低下
Journal of Consumer Researchに掲載された研究](https://doi.org/10.1086/209336)によると、情報過多は意思決定の質を低下させ、その影響は関連性のない情報と関連性のある情報の比率が大きくなるにつれて大きくなります。目に見えるオーサリング・コントロール、ナビゲーション・ツリー、メタデータ・フィールドを持つドキュメント・ページは、書くためにそこにいないすべての読者にとって、その比率を増加させます。
コンテキスト・スイッチングには実際のコストがあります。
インタフェースのシグナルが "あなたはこれを編集することができます "と言うとき、それは "これを読んでください "とは異なる認知フレームを活性化します。カリフォルニア大学アーバイン校でのグロリア・マークの研究では、注意とマルチタスクについて、コンテキスト・スイッチの後、完全に集中し直すのに平均23分15秒かかることがわかりました。編集を一瞬考えた読者は（たとえ誤字を直すためであっても）、読書モードから引き離されてしまったのです。これは仮説ではありません。Notionを使ったことがある人なら誰でも、テキストを選択するためにクリックして、誤ってタイプし始めた経験を知っています。
同じコンテンツでも、読者と書き手のニーズは異なります。
ライターは、構造、フォーマットマーカー、ブロックタイプ、メタデータ、コラボレーションのシグナルを見る必要があります。完全な機械が必要なのです。
読み手は、きれいなテキスト、明確な階層構造、探している情報への最短経路を見る必要があります。必要なのはコンテンツであり、機械ではありません。
同じインターフェイスから両方を提供することは、どちらも実際に行っていることに最適化されたエクスペリエンスを得られないことを意味します。
そして、3つ目のオーディエンスがいます：AI
これは複雑な問題で、既存のプラットフォームはまったく準備ができていません。
2026年のドキュメンテーションには、2人ではなく3人の消費者がいます：
1.コンテンツを作成し維持するライター。 2.コンテンツを視覚的に消費する読者。 3.プログラムでコンテンツを取得、解析、合成するAIシステム 3.
これらのオーディエンスはそれぞれ、同じ基礎となるコンテンツに対して根本的に異なるインターフェイスを必要としています。
ライターには、豊富な編集ツール、コラボレーション機能、構造的なコントロールが必要です。読者は、気が散るのを最小限に抑えた、すっきりとした、集中力のあるプレゼンテーションを必要としています。AIは、明示的なメタデータ（鮮度シグナル、分類ラベル、ブロックレベルのアドレス指定、きれいなセマンティックマークアップ）を持つ、構造化された機械解析可能な出力を必要とします。
Builders, Not Developers](/ja/blog/builders-not-developers-how-claude-changed-devrel/)で述べたように、AI仲介者は、知識労働者の増加するシェアにおいて、すでにドキュメントの支配的な消費者となっています。GitHubの2024年開発者調査によると、企業開発者の97%がAIコーディングツールを使用したことがあります。2026年には、開発者の84%がAIツールを常用し、全コードの41%がAIによって生成されるようになります。
これらのAIシステムは、あなたのサイドバーやツールバーを気にしません。必要なのはクリーンなデータです。そして、読み手の視点と書き手の視点を混同しているプラットフォームは、AIが消費可能な表面と人間のオーサリングの表面を混同しています。1つのインターフェースに3つのミスマッチがあるのです。
3つのオーディエンス、3つの異なるニーズ](/ja/blog/img/readers-writers-three-audiences.svg)
ラセピはどのように体験を分けるか
ラセピは、コンテンツを作成することとコンテンツを消費することは異なる活動であり、異なるインターフェースに値するという原則に基づいて構築されています。
書き手の環境
ラセピで文章を書くとき、完全なオーサリング環境を手に入れることができます。TipTapによるリッチテキスト編集、ブロックレベルコントロール、翻訳ステータスインジケータ、有効期限管理、コラボレーションツール、コンテンツ構造ビューなど、ライターが高品質なドキュメントを作成・維持するために必要なものが全て揃っています。
ライターが機械を見るのは、機械が必要だからです。
<スクリーンショット：Rasepi ライティング環境 -->
読み手の環境
誰かがラセピの文書を読むとき、クリーンで、集中した読書体験を見ることができます。編集用のクロームはありません。ツールバーもありません。修正できますよ」というシグナルもありません。ただコンテンツが、理解とスキャンのために最適化されたレイアウトで表示されます。
読者は編集ボタンを見ません。彼らは何かを学ぶため、プロセスをたどるため、答えを見つけるためにここにいるのです。インターフェイスはその意図を尊重しています。
<スクリーンショット：ラセピの読書体験 -->
AIの表面
AIコンシューマーのために、ラセピは構造化されたAPIを通じてコンテンツをフルメタデータで公開します。各ブロックには、鮮度スコア、翻訳状況、コンテンツハッシュ、分類ラベルが含まれています。AIシステムは、ブロックレベルでコンテンツを照会し、鮮度によってフィルタリングし、古くなったものや草稿を除外し、必要な構造化データを正確に取得することができます。
Wikiのページをスクレイピングしてベストを期す必要はありません。AIは、読み手や書き手と同じように、専用のインターフェースを手に入れることができます。
<スクリーンショット：ラセピAIサーフェス/API -->
コンテンツレイヤーは1つ、インターフェースは3つ
重要なのは、コンテンツのコピーを3つ維持しないことです。これは、Stop Maintaining Five Copies of the Same Documentで説明した、5つのコピーのオンボーディングの問題ではありません。
これは、構造化されたブロックとして保存された1つのコンテンツレイヤーで、3つの異なるオーディエンスに最適化された3つの異なるビューを通して提供されます。
書き手はブロックを編集します。読者は、組み立てられ、スタイリングされたコンテンツを見ます。AIはメタデータを含む構造化データを照会します。同じブロック。真実のソースは同じ。消費者ごとに異なるプレゼンテーション・レイヤー。
これはブロック・レベル・アーキテクチャだからこそ可能なのです。各コンテンツは、独自のメタデータを持つ個別にアドレス指定可能なユニットです。それらのブロックを、誰が求めているかによって、異なる形で提示することができます：
| オーディエンス｜ニーズ｜ゲッツ |----------|-------|------| | 書き手**｜フォーマット、構造、コラボレーション、メタデータ｜ブロックレベルのコントロールを備えた完全なオーサリング環境 | 読者**｜クリーンなテキスト、明確な階層構造、高速なスキャン｜フォーカスされた読書ビュー、クローム編集なし｜AI*｜構造化されたテキスト、構造化された構造、コラボレーション、メタデータ｜ブロックレベルのコントロールを備えた完全なオーサリング環境 | AI*｜構造化されたデータ、鮮度スコア、分類｜完全なメタデータを備えたブロックレベルのAPI｜AI｜構造化されたデータ、鮮度スコア、分類｜完全なメタデータを備えたブロックレベルのAPI
見た目以上に重要な理由
これを読んで、あなたはこう思うかもしれません。同じものの異なるビュー。そんなに重要なことか？"
とても重要なことがわかりました。
読者の信頼
人は公開されているように見えるコンテンツを信用します。ページが誰でも編集できるウィキのように見えると、読者は無意識のうちにそれを否定します。同じコンテンツがきれいで、出版物並みの読みやすさで表示されると、より権威があります。これは不合理ではありません。誰かが真剣にプレゼンテーションに取り組んだというシグナルであり、それは彼らがコンテンツにも真剣に取り組んだことを意味します。
ニールセン・ノーマン・グループはこのことを幅広く研究しています。彼らのコンテンツの信頼性に関する研究によると、デザインのクオリティとプレゼンテーションは、ユーザーがコンテンツの信頼性を評価する際に最も頼りにするシグナルです。乱雑なエディタビューは、それが表示するコンテンツの信頼性を積極的に損ないます。
ライターの生産性
専用のオーサリング環境で作業するライターは、"読んでいるのか、書いているのか "をコンテクストで切り替える必要はありません。ツールがそこにあるのは、それがそこにあるべきものだからであって、インターフェイスが誰がそれを見ているのか判断できなかったからではありません。
AIの信頼性
AIシステムが構造化されたメタデータを持つ専用サーフェスを持つことで、何を取得し、何を除外するかについてより良い決定を下すことができます。ブロックを回答に含める前に鮮度スコアをチェックできます。分類ラベルを尊重することができます。言語、ステータス、オーディエンスによるフィルタリングも可能です。AIが人間の読者のためにデザインされた同じHTMLページをスクレイピングしているときには、そのようなことは不可能です。
メンタルモデルの転換
ほとんどのドキュメンテーション・プラットフォームの基本的な前提はページが単位であり、誰もがページと相互作用します。
ラセピの前提は違います：ラセピの前提は違います：「ブロックが単位であり、様々なオーディエンスが目的のために作られた表面を通してブロックと対話する」_。
それは建築上の小さな違いのように聞こえます。そうではありません。それは、AIシステムに偶然コンテンツを見せるツールと、意図的に見せるツールの違いです。たまたま読みやすい文章を書く環境と、ゼロからデザインされた読書体験の違い。1つで十分なインターフェースと、3つの優れたインターフェースの違い。
ドキュメンテーションはもはや、ただ書いて読むだけのものではありません。書かれ、読まれ、照会され、翻訳され、採点され、分類され、大規模にAIシステムに提供されます。単一のインターフェイスでそのすべてを最適化することはできませんし、できるように見せかけることが、誰も読みたがらないWikiや、AIアシスタントが機械的に消費されるように設計されていないページから答えを引き出すような事態を招いたのです。
読者と作家は異なる精神モードにあります。AIはまったく別のモードです。インターフェースはそれを反映すべきです。
