- 開発者が実際に読み、共有するブログ記事をどう書くべきかについての実践的なガイド
- 著者は9年間のソフトウェアブログ運営経験と数百万回の閲覧実績をもとに、成功した投稿と失敗した投稿の違いを分析
- Hacker News、Reddit、Lobsters などの開発者コミュニティで注目される記事の共通点と戦略を紹介
なぜ著者を信頼できるのか
- 著者は9年間にわたり個人開発ブログを運営しており、年間30万〜50万人の読者が訪問
- Hacker News のトップページに30回以上掲載され、そのうち多くが1位を記録
- 1本のブログ記事をきっかけに成功したインディービジネスを立ち上げ
- Reddit や Lobsters などでも継続的に言及されている
- Hacker News 上で48番目に人気のある個人ブログと評価されている
要点を素早く伝える
- 多くの開発者ブロガーは記事の冒頭ですぐ本題に入らず、読者の離脱を招いている
- 読者は記事を読み始めるとき、次の2つの質問への答えを期待している:
- この記事は自分のような人のためのものか？
- この記事を読むことで自分は何を得られるのか？
- この2つの質問には、タイトルと最初の3文の中で答えるべき
- 読者が関心を持つテーマや用語を使い、過度に専門的な用語や背景説明は避けるべき
- 記事がもたらす価値には、次のようなものがある:
- 日常生活や業務にすぐ応用できる手法
- わかりやすい概念説明
- 技術や業界に関する洞察
- 共感できる興味深いストーリー
-
例: “if got, want: A Simple Way to Write Better Go Tests”
- タイトルと最初の1文だけで次の点が明確:
- 対象読者: Go 言語の利用者
- 得られる価値: 30秒で新しいテストの書き方を学べる
対象読者を広げる方法
- ほとんどのブロガーは特定の少数の開発者を対象に記事を書く（例: 中上級の Java 開発者）
- 表現を少し調整するだけで、より広い範囲の読者に届くようになる（例: すべての Java 開発者 → すべての開発者 → 技術に関心のある人）
- 背景知識のない読者でも理解できるように用語や説明を少し変えるだけで、到達範囲は10倍に広がる
- ただし、あまりに汎用的に広げすぎると記事の深さや専門性が損なわれることがある
-
例: “How I Stole Your Siacoin”
- もともとは特定の暗号通貨コミュニティ向けの記事だったが、
- 用語や説明を一般化し、暗号通貨を知らない人でも理解できるように修正
- その結果、Reddit、Hacker News などさまざまなコミュニティで人気記事になった
読者に届く経路を計画する
- 記事をうまく書いても、読まれなければ意味がない
- Google 検索で上位表示されにくいテーマは避けるべき
- コミュニティ（例: Reddit、Hacker News など）で共有できる現実的な計画が必要
- Reddit のように外部リンクを許可しない、あるいは厳しいルールがある場合も多い
- Hacker News はチュートリアルやありふれたテーマに冷淡なことが多い
- ソーシャルメディアで共有しても、フォロワーが多くなければ効果は限定的
-
現実的な経路を設計する必要がある
- テーマを選ぶ前に、その記事がどの経路で読者に届くかを先に考えるべき
- 次の質問を検討する:
- Google 検索で見つけられやすいテーマか？
- すでに数百本の記事があるテーマではないか？
- ターゲット読者が検索するキーワードは何か？
- リンクを共有できるコミュニティはあるか？ そのコミュニティは活発か？
-
例: “Using Zig to Unit Test a C Application”
- Zig は新興技術で競合記事がほとんどなく、検索上位表示に成功
- Hacker News、Lobsters、Reddit (/r/Zig)、Ziggit などでリンクを共有可能
- 結果として、すべてのチャネルで上位の人気記事になった
視覚要素をもっと見せる
- ブログ記事でもっとも効果的な変化は画像を追加すること
- 長いテキストだけの記事は可読性が低い
- 次のような場合には、画像、スクリーンショット、グラフなどを挿入するとよい:
- GUI プログラムの説明 → スクリーンショット
- 数値変化の説明 → グラフ
- サーバー障害などの出来事の説明 → ダッシュボードのキャプチャ
- 複雑な概念の説明 → 図式、ダイアグラム
- 簡単な図なら Excalidraw のような無料ツールが使える
- イラストレーターを雇うのもよい方法（イラスト1点あたり約 $50~100）
- AI 画像より、MS Paint のような単純な図のほうが効果的な場合もある
流し読みする読者のための構成設計
- 多くの読者は最初から最後まで読まず、ざっと見て読むかどうかを判断する
- 流し読みだけで興味を引くには、次の要素が重要:
- 明確で興味を引く見出し
- 適切な画像と視覚的な手がかり
- テキストだけの長い段落を避けること
-
ツール: 流し読み視点で記事を確認する
- Bookmarklet を使うと、記事内の見出しと画像だけが見えるように設定できる
- これにより、流し読みする読者が目にする構造を点検できる
-
例: 構成が退屈な記事 vs. 興味を引く記事
- “End-to-End Testing Web Apps: The Painless Way” → 見出しと画像に魅力がなく失敗
- “I Regret My $46k Website Redesign” → 視覚的な構成が興味を引き成功（初週で15万人が読んだ）
1件のコメント
Hacker Newsの意見
一般的にブログ記事を書くときは、逆ピラミッド構造が最も適している。記事の要点を素早く伝え、その後で詳しく説明することが重要だ。こうすれば、読者が途中で読むのをやめても重要な内容を見落とさない
反対意見: ブログ記事を他人に読まれるように書くことは、ほとんどの人にとって書く目的そのものを失わせる。Web上の文章の大半は読まれず、読まれるために書くことは動機づけにならない
AIにブログやHacker News、Redditの投稿を批判的に評価してもらうよう頼むのが効果的だった。AIのフィードバックは驚くほど有用で、自分が著者ぶった書き方をしていたことに気づいた
「自分が実際に読みたい文章を書け」というルールに従うのがよい。私たちの脳は、自分が作ったものは素晴らしいと錯覚させる。自分の文章を客観的に見られる方法を見つけることが重要だ
Steve BallmerはBill GatesのようにMicrosoft株を分散しなかったが、そのおかげでGatesよりも裕福になった。しかし、1社に全振りするのがよい考えかどうかは疑問だ
個人的に文章に情熱を持っている必要がある。そうでなければ読者はそれに気づき、批判するだろう。書くことは自分のためのものであるべきだ
ブログ記事は常に短くあるべきなのか? 長い文章が必要な場合もあるのか?
Hacker Newsの読者は一般的に暗号資産関連の話題に敵対的であるにもかかわらず、その記事は1ページ目に到達した
ブログ記事を開発者に読まれ、共有されるものにする方法は2つある
人気のあるブログは、提案されたものとは逆のやり方を取ることが多い。しかし、自分のスタイルを見つけ、人気を最適化したい人には有用な助言だ