DocとBlogで引用ルールを変えた理由：個人体験記事の参考文献設計
はじめに
このサイトでは、ドキュメント記事（Doc）とブログ記事（Blog）で引用のルールを変えています。どちらも「正確な情報を掲載する」という目的は同じですが、記事の性質が異なるため、引用が必要になる場面が異なります。この記事では、その判断基準と、体験と事実が混在する文章を書き直す方法を説明します。
レビュー全体の実行順序は12ステップのレビューワークフローに任せ、この記事では「どの主張に引用が必要か」という判断だけを扱います。
ドキュメント記事の引用ルール
ドキュメント記事は、公式製品情報・仕様・手順を説明する記事です。ここで「公式の仕様では〜です」「バージョン3.0のリリースノートに〜と記載されています」と書くときは、その根拠を参考文献として示す必要があります。
ドキュメント記事で引用が必要な情報：
- 公式ドキュメントに基づく仕様・機能の説明
- 外部統計・調査データ
- 法律・規制の内容
- バージョン番号・リリース日などの事実情報
ドキュメント記事は正確性が最優先のため、外部の事実を根拠にする場合はすべて参考文献を付けます。
ブログ記事の引用ルール
ブログ記事は、著者の体験・考え・解釈を中心に書く記事です。体験・意見・解釈は著者自身の観察に基づくものであり、引用は必要ありません。
ブログ記事で引用が不要な情報：
- 著者が実際に試したことの観察結果
- 著者の判断・選択の理由
- 著者の考え・意見・推測
ただし、ブログ記事でも外部の事実を根拠として使う場合は引用が必要です。「〇〇の調査では〜%です」「バージョン〇〇では仕様として〜になっています」という記述は、ブログ記事でも参考文献が必要です。
体験と事実が混在する文の書き直し方
引用の判断が難しいのは、体験と外部事実が1つの文の中に混在しているケースです。
混在した例：
「Claudeを使い始めた頃、コンテキストウィンドウの制限で長い文章を一度に処理できないことがありました。現在のバージョンでは処理できる文脈の長さが大幅に広がっています。」
この文には、「処理できないことがありました」という体験部分と、「現在のバージョンでは大幅に広がっています」という仕様に基づく事実部分が混在しています。体験部分は引用不要ですが、仕様情報として書く場合は引用が必要です。
書き直した例：
「Claudeを使い始めた頃、長い文脈を扱う処理で制約を感じることがありました。（仕様情報として書く場合はここに引用番号を付ける）」
体験部分（「制約を感じることがありました」）と仕様情報部分を分けて書くことで、どちらの根拠で書かれているかが明確になります。
なぜ混在すると引用判断が難しいか
体験と事実が混在する記事で引用が難しい理由は、「体験として書いているつもりでも、外部事実を根拠にしている」という状況が起きやすいためです。
例えば「設定が複雑で時間がかかりました」は体験として書けますが、「設定には〇〇という手順が必要です」はサービスの仕様を根拠にした記述であり、引用が必要です。著者が「体験として書いた」と思っていても、内容が外部仕様の説明になっている場合があります。
この問題を確認するには、「この主張の根拠は著者自身の観察か、それとも外部の情報か」と問うことが効果的です。外部情報を根拠にしている場合は引用が必要、著者自身の観察に基づく場合は引用不要という判断になります。
まとめ
DocとBlogで引用ルールが異なる理由は、記事の性質の違いにあります。Docは外部の事実を正確に伝えることが目的であり、引用が広く必要です。Blogは著者の体験・解釈を伝えることが中心ですが、外部事実を根拠にする部分には引用が必要です。「この主張の根拠は著者自身の観察か、外部の情報か」という問いを持つことで、引用が必要かどうかの判断が整理できます。