Isolineがガイドを調査・維持する方法

対象範囲と責任

Isolineの一般向けガイドは、ブラウザーの分離、プライバシー、セキュリティ、テスト、チーム業務を読者が理解できるよう支援します。各ガイドは、それぞれ異なる読者の疑問に答え、情報源の要約を超える独自の整理と考察を加えなければなりません。任意の文字数を満たすため、またはわずかな検索語の違いを網羅するためにページを公開することはありません。

署名欄の「Isoline編集チーム」は、架空の個人ではなく、組織としての公開機能を示します。Isolineの開発中も、責任の所在を一つの安定した窓口に置くための名称です。ガイドには、一般情報、採用済みの設計方針、提供済み機能の根拠、またはそれらを明確に分けた複数の対象範囲のうち、どれを扱うかを記載しなければなりません。

調査と情報源の選定

調査では、仕様、ブラウザーやプラットフォームの公式文書、ソースリポジトリ、リリース成果物、権威あるセキュリティ指針を優先します。情報源は、望ましい結論を繰り返しているからではなく、特定の記述を裏づけるために選びます。各情報源の記録には、内容を表すタイトル、公開元、URL、参照日、何を裏づけるかの説明を含めます。

変化し得る技術的事実は、実質的な更新の前に再確認します。ベンダーが公開した記述は、そのベンダーが何を文書化しているかの根拠にはなりますが、セキュリティ、信頼性、普及状況、成果を独立して証明するものではありません。公開情報が見つからない場合は不明として記録し、その機能が存在しない証拠とは扱いません。

事実確認と製品の状態

編集担当は、事実に関する記述を引用資料と照合し、レンダリングされたページ全体について、文脈、リンク、日付、限界、主張の状態を確認します。自動チェックでは、根拠の欠落、重複ルート、壊れた内部リンク、見えないインデックス制御、余分なページレベルの見出し、記録済みの根拠段階を超える発売前の製品主張を拒否します。

Isolineは開発中です。一般情報を、製品を実際に使用した根拠として示してはなりません。採用済みの設計方針は方針であると明記し、それを裏づける意思決定記録または公開された製品状況の情報源へリンクする必要があります。提供済み機能に関する主張には、公開され、再現可能な根拠が必要であり、プロジェクトがFoundation段階にある間は公開できません。

AIの利用

AIツールは、情報源の発見、構成案の作成、文章の調整、一貫性の確認、検証を補助する場合があります。AIツール自体を情報源とは扱いません。また、経験、利用者、測定値、引用、スクリーンショット、製品の提供状況、情報源の結論を捏造してはなりません。

AIを利用しなかった場合も含め、各ガイドにはAI利用の開示を記載します。AIが大きく関与しても編集上の責任はなくならず、情報源と事実確認の要件が緩和されることもありません。

訂正

読者はガイドの訂正をメールで報告できます。有用な報告には、ページURL、該当箇所、提案する訂正、裏づけとなる根拠を含めてください。パスワード、Cookie、プロキシ認証情報、二要素認証の機密情報、プロファイルデータ、その他の機密情報は送らないでください。

重要な訂正は記事に記録し、内容の変更日を更新するとともに、同じ主張が現れるすべての箇所で確認します。軽微な誤字、書式、アクセシビリティの修正について、実態に反する鮮度の日付を付けることはありません。

公開と内容の更新

公開日は、ガイドが初めて公開ルート群に加わった日を記録します。変更日は、目に見える結論、説明、限界、推奨、情報源に依存する事実、または訂正が意味のある形で変わった場合にのみ更新します。ビルド時刻を編集上の日付として使うことはありません。

公開前に、ガイドには簡潔な要約、有用な見出し構造、内容を表すリンク、限界、編集上の対象範囲に関する注記、アクセシブルな情報源の表示、読者の助けになる場合の文脈に沿った関連記事が必要です。草稿、確認中、公開終了の項目は、公開ルート、フィード、サイトマップから除外します。

ローカライズ

英語を共通の原文とします。言語に依存しない安定したページIDで各言語版を結び、各ロケールは原文のスラッグを再利用するか、確認済みの独自スラッグを定義できます。翻訳ルートは、記事全体、メタデータ、情報源の文脈、開示、インターフェース文言がその言語で確認された場合にのみ公開します。翻訳がない場合は、英語へのフォールバックページに置き換えず、そのルート自体を公開しません。