結論を先に示す
長い前置きの後でしか答えが分からない構成を避けます。最初に結論を示し、その後で条件、手順、注意点を説明します。
根拠の優先順位
- 公式ドキュメント、公式ヘルプ、公式リリースノート
- 実際の画面・実機確認
- 信頼できる技術資料
- 第三者情報は発見の手掛かりとして扱う
確認状態を分ける
公式情報確認済み、実機確認済み、条件付き、一部確認、未確認、情報更新待ちなどを記事データとして保持します。公式資料を読んだことと、実際に操作したことは同じ扱いにしません。
環境と日付
OS、版、プラン、地域、アカウント種別、確認日、最終更新日など、結果に影響する条件を可能な範囲で記録します。
公開前チェック
- 結論と本文が一致している
- 確認状態が過大ではない
- 公式URLと確認日がある
- 未確認事項が隠されていない
- 内部リンクと日付が正しい