編集方針
誰が書き、誰が確認し、どこまで終わっているかを公開するためのページです。読む側が、内容をどのくらい信用してよいかを判断できる状態にしておくことを優先します。
事実を決めるのは人です
下書きの作成にはAIを使っています。文章の構成や説明の言い回しはAIが担当します。ただし、AIが事実を決めることはありません。料金、制限、利用条件などの事実は、公開前に人が公式資料と1件ずつ突き合わせます。突き合わせが終わっていない項目は「要確認」のままにします。
現在の状態
そのため、API提供事業者の情報、比較、ガイドなどのコンテンツページは編集ステータスをneeds-reviewとして扱い、検索エンジンにインデックスされないよう noindex を出力しています。人手の確認が終わったページからverifiedに切り替え、インデックス対象にします。確認前の内容が、確認済みの情報として検索結果に出ることを避けるためです。
日本語について
本文の日本語は、ネイティブによるチェックを前提としています。機械翻訳の結果をそのまま公開することはしません。用語は、各社の公式ドキュメントで使われている表記に合わせます。開発者が読むことを想定して、敬語は必要な範囲にとどめ、短い文で書きます。
各ページに表示すること
- 著者（署名）
- 情報の最終確認日と、編集ステータス
- 事実の根拠になった公式ページへのリンク
- 訂正を知らせるための連絡先
掲載順序
API提供事業者の既定の並び順は、識別子（slug）のアルファベット順です。広告、スポンサー、アフィリエイトの有無で順序を変えることはありません。関係が生じた場合の扱いは広告・提携の開示に書いています。
用途別の比較ページで順序を変えるかどうかなど、並び順の最終的なルールはまだ確定していません。決まり次第、このページに追記します。
訂正の手順
- 指摘を受け取ります。
- 公式資料にあたって、事実関係を確認します。
- 該当箇所を修正し、そのページの情報の最終確認日を更新します。
- 結論が変わるような大きな修正は、修正内容と日付をページ内に明記します。