先に要点
技術記事を書いていると、公式ドキュメントを見た方がいい、一次情報を当たるべき とよく言われます。
でも実際には、何が一次情報なのか曖昧なまま使われることもかなり多いです。
たとえば、
- ベンダー公式の仕様ページ
- RFC
- 製品の公式ドキュメント
- 著者本人の発表
- 公的機関の制度案内
は一次情報に近いですが、 ブログ記事、まとめ記事、解説動画、SNS投稿は二次情報や三次情報に寄ることが多いです。
この記事では、一次情報 とは何かを整理したうえで、なぜ技術記事で価値が高いのか、二次情報を信じて実際にどう間違えるのか、そして「どこまで追えば十分か」をテーマ別の時間目安つきで解説します。 AI時代の情報設計まで広げて見たいなら、LLMOとは?SEOとの違い・やるべきこと・誤解を徹底解説 もかなりつながりやすいです。
まず結論: 一次情報は「事実の土台」になる
一次情報の価値は、分かりやすく言うと 話の軸がぶれにくいこと です。
技術記事では、どうしても解説者の解釈が入ります。 それ自体は悪くありません。むしろ解説記事には必要です。
ただ、元の仕様や公式発表を見ずに解説だけを重ねると、
- 古い情報をそのまま広める
- 制約条件が抜ける
- 例外条件が消える
- 断定が強くなる
というズレが起きやすいです。
そのため、一次情報は 全部そのまま写すため ではなく、解釈が暴走しないための土台 としてかなり重要です。
二次情報を信じて間違える、よくある実ケース
抽象論だと「一次情報は大事」で終わってしまうので、実際に二次情報だけを見て間違えるパターンを、現象→原因→確認手順→回避の形で挙げます。どれも特殊な事例ではなく、技術記事でかなり頻発するタイプです。
ケース1: 廃止された RFC をいまも有効として引用してしまう
現象
記事で「HTTP のステータスコードは RFC 7231 で定義されている」と書いたが、レビューで「それ、もう廃止されていませんか」と指摘される。
原因
古い解説記事や、数年前の書籍を二次情報としてそのまま引いたため。HTTP/1.1 のセマンティクスは 2022年6月に RFC 9110(HTTP Semantics)が公開され、RFC 7230〜7235 系をまとめて obsolete(廃止)している。二次情報は RFC 7231 のままで止まっていることが多い。
確認手順
原典(IETF / RFC Editor)の RFC ページ冒頭を見る。廃止された RFC のページには Obsoleted by: 9110 という表記が必ず出る。新しい RFC 側にも Obsoletes: 7230, 7231, 7232, ... と書かれている。両方を突き合わせれば一発で分かる。
回避
RFC 番号を本文に書くときは、必ず RFC Editor の当該ページを開いてステータス(Internet Standard / Obsoleted など)を確認する。現行を引きつつ「旧 RFC 7231 を統合した RFC 9110」と書けば、古い読者の検索語ともつながり親切。
ポイントは、RFC 7231 の内容自体が「全部間違い」になったわけではないことです。中身は概ね RFC 9110 に引き継がれています。それでも番号と参照先がずれているだけで、記事の信頼性は一気に落ちます。原典を 1 分見れば防げる事故です。
ケース2: localStorage の容量を「10MB」と書いてしまう
現象
「localStorage はブラウザごとに約 10MB 使える」と書いたら、実装してみた読者から「Chrome で 6MB くらいで QuotaExceededError が出る」と報告が来る。
原因
「10MB」と書いている二次情報を孫引きしたため。HTML 仕様(WHATWG)が示す目安は 1 オリジンあたり 5MiB(約 5.24MB)。「10MB」は localStorage と sessionStorage を合算した枠や、特定ブラウザの古い挙動を指していることが多く、数字の前提がずれている。さらに UTF-16 で 1 文字 2 バイト換算になる点も誤差を生む。
確認手順
原典(WHATWG HTML Standard の Web Storage 節、MDN の Storage quotas ページ)で「5 MiB / per origin」という記述を確認する。あわせて DevTools の Console で実測する。
回避
「仕様上の目安は 1 オリジンあたり約 5MiB。ブラウザや条件で前後する」と幅で書く。断定的に「10MB」と書かない。実測コードも添えると一次情報に近い独自価値になる。
実測は次のような短いコードで確認できます。Console に貼るだけで、その環境の実効上限が分かります。
let data = "x".repeat(1024 * 1024); // 1MB 相当の文字列
let i = 0;
try {
for (; i < 20; i++) localStorage.setItem("test" + i, data);
} catch (e) {
console.log(`${i}MB 付近で停止: ${e.name}`); // 多くの Chrome で 5MB 前後
} finally {
for (let j = 0; j <= i; j++) localStorage.removeItem("test" + j);
}
典型的な出力は 5MB 付近で停止: QuotaExceededError です。「10MB と書いてあったのに半分で落ちた」という読者のつまずきは、この一手間で消えます。
ケース3: 料金の「無料枠」が原典と解説記事で食い違う
料金と無料枠は、二次情報がもっとも早く陳腐化する領域です。Vercel の Hobby(無料)プランを例にします。
| 観点 | よくある二次情報の説明 | 公式(原典)の現行仕様 |
|---|---|---|
| 帯域 | 「個人なら実質無制限」「気にしなくてよい」 | Hobby は転送量に上限がある(月 100GB 目安) |
| 上限超過時 | 「課金されて続く」 | Hobby は従量課金に移行できず、上限到達でデプロイが一時停止しサイトが落ちる |
| 商用利用 | 「無料で使える」 | Hobby は商用利用が原則不可。商用は Pro 以上が必要 |
現象
「無料で十分」と紹介した記事を読んだ人が、小規模な商用サイトを Hobby で運用 → ある日トラフィックが伸びてサイトが止まる、または規約面で商用利用に引っかかる。
原因
無料枠の数値と「上限を超えたときの挙動」は改定が多い。1〜2 年前の解説記事を引くと、当時は正しくても現在は外れていることがある。Pro 以上の超過課金(例: 追加帯域は 100GB あたり数十ドル規模)も改定対象。
確認手順
公式の Pricing / Limits / Fair Use ページを開き、ページ内の更新日と現在の数値を見る。「無料 = 無制限」ではなく「無料 = 上限あり・超過時の挙動つき」で理解する。
回避
料金・上限は数値を断定せず「執筆時点では月 100GB 目安。最新は公式 Pricing を参照」と参照日つきで書く。デプロイ先を勧める記事ほど、この一行が読者の事故を防ぐ。
数値そのものは変わるので「いくらか」より「どこを見れば現在値が分かるか」を読者に渡すのが、料金記事での一次情報の正しい使い方です。
技術記事で一次情報が特に価値を持つ理由
上のケースを踏まえると、価値の出どころは次の 4 つに整理できます。
1. 誤情報を減らしやすい
技術記事で一番つらいのは、もっともらしく間違うことです。 特に、仕様、料金、制限、挙動、推奨構成は、伝言ゲームで崩れやすいです。先の RFC や localStorage の例がまさにこれです。
公式ドキュメントや仕様書を見ていれば、少なくとも
- 何が正式に書かれているか
- どこまでが保証されているか
- 何が未定か
を切り分けやすくなります。
2. 更新差分を追いやすい
技術の話は変わります。 ライブラリ、クラウド、補助金、ガイドライン、ブラウザ挙動など、かなり普通に変わります。
一次情報を基準にしていると、
- 何が変わったか(RFC なら Obsoletes/Updates、料金なら更新日)
- いつ変わったか
- 今も有効か
を追いやすいです。二次情報だけ見ていると、どこが古くなったのか分からないまま引用してしまいます。
3. 事実と意見を分けやすい
これはかなり大きいです。たとえば、
公式にはこう書かれている実務ではこう使われがち自分はこう考える
を分けて書けると、記事の信頼性はかなり上がります。一次情報を見ていないと、この 3 つが混ざりやすいです。
4. 独自の価値を足しやすい
意外かもしれませんが、一次情報を見た方が、解説記事の独自性は出しやすいです。localStorage の実測コードのように、原典 + 自分で確かめた結果はそれ自体が他にない情報になります。単なるまとめ直しではなく、どこが重要か・どこで実務とつながるか・どこが初心者のつまずきになるかを、自分の視点で整理できます。
一次情報の例と、そうでないもの
かなりざっくり分けるとこうです。
| 種類 | 例 | 一次情報に近いか |
|---|---|---|
| 公式仕様・公式ドキュメント | ベンダー公式 docs、RFC、公式料金表 | 高い |
| 原著者や公式機関の発表 | 製品開発元ブログ、公的機関の公表資料 | 高い |
| 解説記事・比較記事 | 個人ブログ、技術メディア記事 | 中〜低 |
| SNS・要約投稿 | X、まとめ投稿、短文共有 | 低い |
もちろん、二次情報が全部悪いわけではありません。 むしろ、分かりやすい二次情報はかなり助かります。ただ、二次情報だけで書くと、元の文脈や更新が抜けやすいだけです。
一次情報と二次情報を、具体例で並べて比べる
種類で分けた表だけだと、いざ書くときに「これはどっち寄り?」で迷います。筆者(SE歴9年以上)が記事を書くときに実際にやっているのは、まず手元の情報源を「誰が直接出したか」で一次・二次に振り分ける作業です。判断軸は一つで、その情報を最初に決めた・計測した当事者が出しているか です。下表は、技術記事でよく出てくるテーマごとに、一次情報と二次情報の具体例を並べたものです。
| テーマ | 一次情報(当事者・公式が直接) | 二次情報(解説・要約・伝聞) |
|---|---|---|
| HTTP の仕様 | RFC Editor の RFC 9110 原文 | 「HTTPステータス入門」系のまとめ記事 |
| クラウド料金 | 提供元の公式 Pricing ページ | 「無料で実質無制限」と書いた個人ブログ |
| ブラウザ挙動 | WHATWG の仕様、自分の DevTools 実測値 | 「localStorage は10MB」と書いた解説動画 |
| ライブラリの使い方 | 公式ドキュメント、README とリリースノート | 技術メディアの入門記事 |
| 公的制度・補助金 | 所管省庁・機関の公表資料、原文 PDF | 制度をかみ砕いた解説サイト、SNSの要約投稿 |
| AI モデルの仕様 | 提供元の公式発表・モデルカード | 「使ってみた」系の伝聞、スクショ転載 |
ポイントは、二次情報が悪いのではなく 役割が違う ことです。一次情報は数値や制約などの「事実」を確定させる側、二次情報は「初心者がどこでつまずくか」「どう噛み砕くか」を教えてくれる側です。筆者の場合、事実の出どころは必ず左列に置き、右列は「整理の参考」までにとどめます。たとえば AI の出力やSNSの伝聞は、便利でも左列(根拠)には決して入れません。
出典を確認するときの実務チェックリスト
記事を書くとき、筆者が情報源ごとに頭の中で通している確認項目を、そのままチェックリストにしました。1 件あたり数分で回せます。
1. 出どころは当事者か
その数値や仕様を最初に決めた・計測した本人(公式提供元、原著者、発行機関)までたどれるか。たどれない場合は「二次情報どまり」と割り切り、本文では断定を避けます。
2. 現行版か
RFC なら冒頭の更新表記、公式ドキュメントなら対象バージョンと更新日、料金ページなら更新日を見ます。古いページを「公式だから」と信じるのが一番危ない落とし穴です。
3. 数値に前提が付いているか
容量・上限・料金は、単位と適用範囲をセットで確認します。1 オリジン単位か合算か、無料枠の上限到達時はどうなるか。前提が抜けた数字は孫引き事故の温床です。
4. 自分で裏取りできるか
仕様値はできれば DevTools やコマンドで実測し、原典と突き合わせます。複数の一次情報を照合する、動かして確かめる、の二段確認が一番強い根拠になります。
5. 事実と解釈を分けて書けるか
「公式にはこう書かれている」「実務ではこう困りやすい」「自分はこう考える」を本文で分離します。混ざると、読者は何が根拠で何が意見か判断できなくなります。
このうち一つでも引っかかったら、その情報は本文の根拠としては保留にします。逆に、5 項目を通った情報は、参照日や RFC 番号を添えて堂々と引用できます。完璧に全部を毎回やる必要はなく、「変わりやすい × 間違えると実害が出る」テーマほど 5 項目を丁寧に回す、という温度調整で十分回せます。
一次情報だけで書けばいいのか
ここは違います。
実務では、一次情報だけで記事を書くと、逆に読みにくくなることがあります。 公式ドキュメントは正確でも、初心者向けにそのまま読みやすいとは限らないからです。
かなり現実的には、次の流れがよいです。
つまり、一次情報は それだけで完成する素材 というより、記事の芯を作る材料 と見た方が自然です。
どこまで追うか: テーマ別の時間目安
毎回すべての原典を読み込むのは重いです。現実には、テーマごとに「どこまで追うか」を時間で区切ると回しやすくなります。下表は 1 トピックあたりの目安です(記事全体ではなく、確認 1 件あたり)。
| テーマ | 追う深さの目安 | 時間目安 | 最低限の確認ポイント |
|---|---|---|---|
| 料金・無料枠・上限 | 公式 Pricing/Limits を必ず開く | 10〜15分 | 数値・更新日・超過時の挙動・商用可否 |
| クラウド機能・API 仕様 | 公式 docs の該当ページ + 変更履歴 | 15〜30分 | 対象バージョン、Deprecated 表記、リージョン差 |
| RFC・標準仕様 | RFC Editor で番号とステータス | 5〜10分 | Obsoleted/Updated by、Internet Standard か否か |
| セキュリティガイドライン | 一次発行元(NIST/IPA等)の原文 | 20〜45分 | 版番号、適用範囲、最新改定日 |
| 基礎概念(TCP/IP、Cookie、トランザクション等) | 一次を軸に概念整理、毎回深追い不要 | 5〜15分 | 用語の定義ぶれがないか1点だけ照合 |
| ブラウザ挙動・Web API | 仕様(WHATWG/W3C)+ DevTools 実測 | 15〜30分 | 仕様値とブラウザ実装の差、エラー名 |
線引きの考え方はシンプルです。「変わりやすい × 間違えると実害が出る」ものほど時間をかける。料金やセキュリティは上に、安定した基礎概念は下に置きます。基礎概念は最新性より整理が重要なので、一次を軸にしつつ毎回重く調べすぎなくてもよいことがあります。
一次情報ベースの記事がSEOやLLMOでも強い理由
Google Search Central の helpful content guidance でも、検索エンジン向けに作っただけのページより、人に役立つ信頼性の高い情報が重要とされています。
また、AI検索や LLMO の文脈でも、
- 根拠がある
- 定義が明快
- 更新されている
- 引用元がたどれる
記事はかなり扱いやすいです。RFC 番号や更新日、参照日を明記した記事は、AI が「どこ由来の主張か」を判定しやすく、引用されやすくなります。
つまり、一次情報ベースで書くことは 検索向けの裏技 ではなく、情報の密度と信頼性を上げることで結果的に強くなりやすい という整理がかなり自然です。
よくある危ないパターン
まとめ記事だけ読んで断定する
一番起きやすいです。しかも文体が強いほど、それっぽく見えてしまいます。先の「無料で実質無制限」がまさにこれです。
公式情報を見たつもりで古いページを使う
公式でも古い情報はあります。RFC 7231 のように廃止表記が付いているもの、公式 docs の旧バージョンページなどです。公開日、更新日、対象バージョン、Deprecated 表記を見る方が安全です。
一次情報を読まずに「実務ではこう」と言い切る
実務知見は大事ですが、仕様と逆のことを書くと危ないです。実測値を添えるなら、それがどの環境のものかも書きます。
実際のやり方を短く言うと
技術記事を書くなら、まず次を決めるとかなり楽です。
- このテーマは最新確認が必要か(料金・仕様は Yes 寄り)
- 公式の一次情報は何か(docs か RFC か発行元原文か)
- どこからどこまでが事実で、どこからが解釈か
- 実務例・実測をどこへ入れるか
新しい技術や制度を書くときは、最初に公式ドキュメント・仕様ページ・公的機関の案内を1〜3本だけ押さえ、料金や上限は更新日と現在値をメモしてから、比較記事や実装例を見る流れにすると整理しやすいです。本文では 公式にはこう書かれている と 実務ではこう困りやすい を分けて書くと、読みやすさと信頼性を両立しやすくなります。
一次情報に関するよくある質問
Q. 一次情報と二次情報はどう違いますか?
A. 一次情報は 当事者・公式提供元が直接発信する情報 です。二次情報はそれを解説・要約・再構成したものです。RFC、公式ドキュメント、官公庁の発表が一次情報、ブログ記事や解説書が二次情報の代表例です。
Q. なぜ一次情報を参照する必要があるのですか?
A. 二次情報は誤訳・誤解・古い情報のリスクが高いからです。本文で挙げたとおり、RFC 7231 を現行として引く、localStorage を 10MB と書く、無料枠を無制限と説明する、といった事故は二次情報の孫引きから生まれます。原典で確認する習慣 が信頼性を生みます。
Q. 料金や無料枠はどこまで追えば十分ですか?
A. 公式 Pricing/Limits ページを必ず開き、数値・更新日・超過時の挙動・商用可否の 4 点を 10〜15 分で押さえます。数値は変わるので、記事には参照日を添え「最新は公式参照」と書くのが安全です。
Q. RFC が現行かどうかはどう確認しますか?
A. RFC Editor または IETF Datatracker の当該ページ冒頭を見ます。Obsoleted by が付いていれば廃止済みで、後継 RFC 番号が示されます。HTTP セマンティクスなら RFC 7231 は 2022年6月の RFC 9110 に統合されています。
Q. 英語の一次情報は読まないとダメですか?
A. 重要なテーマほど英語原文を読む価値があります。日本語訳が遅れたり省略されることが多く、最新の正確な情報 は英語原文だけにあるケースが多々あります。翻訳ツールも今は十分実用的です。
Q. ChatGPT の出力を一次情報として使えますか?
A. 使えません。AI は学習データの要約と推測を返すため、事実確認のない情報 を自信を持って返すこともあります。AI 出力は二次情報以下と扱い、必ず一次情報で裏取りします。
Q. 一次情報のリンクが切れていたらどうしますか?
A. Wayback Machine、archive.org でアーカイブを探す、ドメイン変更後の新 URL を探す、関連する別の一次情報源(別の公式ページ)を探す、の順で対応します。
Q. 一次情報の正確性も間違っていることはありますか?
A. あります。仕様書のミス、公式ドキュメントの記述漏れ、誤訳、古い情報の放置などです。一次情報を最優先しつつ、複数の一次情報を突き合わせる 動作実証する という二段確認が安全です。localStorage の実測のように、自分で確かめると最も強い根拠になります。
まとめ
一次情報 は、技術記事における 事実の土台 です。
誤情報を減らし、更新差分を追いやすくし、事実と意見を分けやすくするので、記事の信頼性と密度をかなり上げやすくなります。
ただし、一次情報だけで読者に伝わるとは限りません。 実務では、一次情報で軸を固め、テーマごとに「どこまで追うか」を時間で区切り、二次情報や実測で噛み砕く形が現実的です。
技術記事で本当に価値が出るのは、一次情報を読んだこと自体ではなく、その内容を正しく理解して、役立つ形に整理し直せること だと考えるとかなりしっくりきます。
参考リンク
- Google Search Central: Creating helpful, reliable, people-first content
- IETF RFC Editor: RFC 9110 HTTP Semantics(RFC 7231 を統合)
- WHATWG HTML Standard: Web Storage
- MDN Web Docs: Storage quotas and eviction criteria
- Vercel 公式: Pricing / Limits