content-hackernews

Hacker News のコンテンツ作成

始める前に

1. HN の文化を理解する：Hacker News（news.ycombinator.com）は、知的好奇心と技術的な深さを原動力とするコミュニティです。Y Combinator が運営しており、創業者、エンジニア、研究者、技術に精通した読者が集まります。このコミュニティは、マーケティング表現、最上級の表現、誇大宣伝を嫌います。

2. 投稿の種類を決める：

   • Show HN：自分が作ったものを共有し、コミュニティからフィードバックを得る
   • Ask HN：コミュニティに質問する
   • 通常の投稿：コンテンツ（自分または他者のもの）へのリンクを共有する

3. ブランドのトーンを確認する：brand/VOICE.md があれば読み、hn-voice.md を使って大幅に調整してください。HN は、どのプラットフォームよりも厳しいトーンの要件があります。どのようなマーケティング表現も、投稿へのフラグ付け、低評価、無視につながります。

---

HN の文化

HN が重視するもの

• 知的好奇心と、アイデアへの純粋な関心
• 技術的な深さと厳密な思考
• 正直さ、特に制約やトレードオフについての正直さ
• 新しい洞察と独創的な考え
• 飾り気のない、明快で直接的な文章
• 体裁よりも内容

HN が受け入れないもの

• あらゆる種類のマーケティング表現（「革命的」、「画期的」、「破壊的」）
• 最上級の表現（「最高の」、「最速の」、「最も強力な」）
• 感情に訴える操作やエンゲージメント目的の釣り
• クリックベイトのタイトル
• 自画自賛
• 内容を伴わない誇大宣伝
• コミュニティへの貢献に見合わない過度な自己宣伝

HN の読者層

• 技術に精通しています：読者が技術的な主張を評価できることを前提にしてください
• 細部に注意を払います：曖昧な主張はコメントで指摘されます
• 誇大宣伝に懐疑的です：並外れた主張には、並外れた証拠が必要です
• グローバルです：読者はあらゆるタイムゾーン、さまざまな業界に広がっています
• 時間に余裕がありません：タイトルをざっと読み、選んだものだけをクリックします

---

Show HN の形式とルール

Show HN は、自分のプロジェクト、製品、作品をコミュニティに共有するためのものです。

タイトルの形式

Show HN: [Concise description of what it is]

良いタイトル：

• 「Show HN: Rust で書かれたターミナルベースの Markdown エディター」
• 「Show HN: PostgreSQL のクエリプランを可視化するオープンソースのツール」
• 「Show HN: セマンティック埋め込みを使って学術論文を検索する検索エンジンを作りました」

悪いタイトル：

• 「Show HN: インフラ管理の革命的な新しい方法」（マーケティング）
• 「Show HN: 私のすごいアプリを見てください！」（曖昧で誇大）
• 「Show HN: [ProductName] -- オブザーバビリティ分野に変革をもたらす」（流行語）

タイトルのルール

• どれほど優れているかではなく、何をするものかを説明する
• 関連があれば技術を含める（「Rust で書かれた」、「WASM を使用」）
• 80 文字以内にする
• すべて大文字にしたり、感嘆符を使ったりしない
• 価格や「無料」をタイトルに含めない

付随するコメント

すべての Show HN 投稿には、作成者によるトップレベルコメントを付けてください。このコメントは非常に重要です。構成には show-hn-template.md を使ってください。

コメントでは、次の内容を扱ってください。

1. 何であるか：1 文で、明確かつ具体的に、専門用語を使わずに説明します。
2. 作った理由：直面した問題、またはプロジェクトの動機を説明します。
3. 仕組み：興味のある読者向けに、技術的な概要を簡潔に説明します。アーキテクチャ、主要な技術、興味深い設計上の判断を含めます。
4. 技術的に興味深い点：何を学びましたか？何が難しかったですか？何が新しいですか？
5. 現状と制約：何が動作し、何が動作せず、次に何をするのかを説明します。ここで正直に伝えると、大きな敬意を得られます。
6. 求めるもの：求めているフィードバックを具体的に示します。「フィードバックを歓迎します」では曖昧です。「クエリオプティマイザーのアプローチについて、ぜひフィードバックをいただきたいです」なら、実際に役立つものになります。

---

Ask HN の形式

Ask HN は、コミュニティに向けて質問するためのものです。

タイトルの形式

Ask HN: [Your question]

良い Ask HN の投稿：

• 具体的で、明確に定義された質問
• 多様な経験に基づく回答を促す質問
• 最近、コミュニティに尋ねられていない質問
• 質問者が共有できる背景情報を持っている質問

悪い Ask HN の投稿：

• 検索エンジンで簡単に答えが見つかる質問
• 質問を装ったアンケートや市場調査
• 「[my product]についてどう思いますか？」（代わりに Show HN を使ってください）

本文

• 質問する理由の背景を説明する
• すでに試したことや検討したことを共有する
• 制約や要件を具体的に示す
• 簡潔にまとめる。HN の読者は簡潔さを重視します。

---

標準的な投稿

リンク（ブログ記事、記事、論文、ツール）を投稿する場合：

タイトル

• コンテンツの原題を使います。HN ではこれが好まれます。
• 原題がクリックベイトの場合は、説明的で中立的なタイトルに書き換えます
• 主観的な評価は加えないでください。「X に関する素晴らしい記事」は主観的な評価です。リンクと一緒に「X」とだけ投稿してください。
• 古いコンテンツに「（2023）」、PDF に「（PDF）」を加えるのは問題ありません

投稿のタイミング

• HN は米国の営業時間中（太平洋時間）に最も活発になります
• ピーク時間に投稿すると、初期の閲覧数が増えます
• 週末は競争が少ない一方で、トラフィックも少なくなります

---

フラグや低評価を受ける投稿

HN の取り締まり方針を理解しておくと、問題を避けやすくなります。

フラグが付く（コミュニティまたはモデレーターによって削除される）：

• 明らかに宣伝目的の投稿
• クリックベイトのタイトル
• 最近のストーリーの重複投稿
• 低品質なコンテンツ
• 自己宣伝が過剰なドメインからの投稿

低評価を受ける：

• マーケティング用語を含むコメント
• 批判に対する防御的な返信
• 議論に貢献しないコメント
• 議論と関係のない自己宣伝コメント
• 内容のない「フィードバックありがとうございます！」

見えないペナルティ：炎上検知

• HN には高度な炎上検知機能があります
• 口調が激しいコメントや、相手に配慮しないコメントは自動的に表示順位を下げられることがあります
• 相手がそうしない場合でも、返信では善意に基づいて解釈してください

---

HN の語り口

詳しい語り口のガイダンスについては、hn-voice.md を参照してください。基本的なルールは次のとおりです。

1. 率直に書く。 明確に述べます。前置きは不要です。
2. 技術的に書く。 HN の読者は技術的な深さを期待し、評価します。
3. 制限事項を正直に伝える。 「X はまだうまく扱えません」のほうが、「何でも扱えます」よりも敬意を得られます。
4. 最上級表現を使わない。 「最高」を具体的な比較に置き換えます。
5. マーケティング用語を使わない。 プレスリリースに載せられそうな表現は書き直します。
6. 説明するのではなく、示す。 「高速です」と言う代わりに、ベンチマークを示します。

---

出力チェックリスト

HN コンテンツを提出する前に、次の点を確認してください。

• タイトルは宣伝調ではなく説明的で、80 文字未満である
• マーケティング用語や最上級表現が一切ない
• Show HN の投稿には、内容のある開発者コメントが含まれている
• Ask HN の投稿には背景情報があり、事前に調査したことが示されている
• 関連する場合、技術的な詳細が含まれている
• 制限事項と現状が正直に説明されている
• 技術に詳しく、懐疑的な読者の厳しい検証にも耐えられる内容である
• hn-voice.md のガイドラインに沿った語り口である
• クリックベイト、感情的な操作、エンゲージメント稼ぎがない