ジャーナルに戻る

オープンソース

メンテナのハブは、READMEの複製ではない

利用者、スポンサー、セキュリティ、記者。ボタンは四つで足りる。READMEはクローンする人のため。ハブはクローンしない人のため。Discordを一次のサポートにしない。

2026年10月30日4 minLinkForge Editorial

GitHub のプロフィールは、 クローンする人には便利だ。

名前で検索した記者や、 採用担当や、 資金を出す財団は、 README のディレクトリ構造を読まない。

ハブは、 その人たちの扉だ。

四つの相手、 四つのボタン

相手 先頭にしてよい 先頭にしない
利用者 ドキュメント、クイックスタート 個人の支援のドラマ
スポンサー GitHub Sponsors や Open Collective 四十個のリンク
セキュリティ security.md か専用のフォーム 公開の雑談部屋
記者や仕事 九十語の略歴と講演 ミームの物販

十二個に増やす前に、 この四つかを見る。

増やす原則の逆は 自販機。

クロールできる文に置くもの

何の道具か、 誰向けでないか、 ライセンスの名前、 維持の状態(活発か、 保守のみか)。

状態を日付で書く。

「業界標準」とは書かない。

ソースが無い最上級は、 記者のページでも拒否する。

プレスルーム。

セキュリティを劇場にしない

公開の Discord に脆弱性を書かせない。

連絡先をページに一文で置き、 受け取れる時間帯があれば書く。

報奨金が無いなら、 無いと書く。

あるふりをしない。

ファンではないスポンサー

企業のスポンサーは、 好き嫌いではなく、 請求と露出の条件で来る。

ファン向けの文章と、 請求の経路を一つの「支援」ボタンに混ぜると、 経理が止まる。

人間への一文は残してよい。

暗号資産のミントと、 支援を同じボタンにしない。

そこから会社の信頼が落ちる。

README とハブ

README はクローンする人のためだ。

ハブは、 クローンしない人のためだ。

一行の説明は重複してよい。

アーキテクチャの全文は重複させない。

ハブから README へリンクする。

よくある質問

GitHub のプロフィール README で置き換わるか

GitHub の中の人には役立つ。

自分の名前での検索では、 ドメインか LinkForge のページの方が文書として残しやすい。

両方持ってよい。

制御して更新するのは、 自分でその夜に直せる方だ。

すべてのリポジトリを並べるか

三つをピンする。

残りは組織のアカウントへ。

一覧をボタンにすると、 自販機に戻る。

Discord をコミュニティの先頭にするか

二次でよい。

一次はドキュメントと、 issue の書き方だ。

自分がヘルプデスクにならないためだ。

受信箱を Studio は代行しない。

机の境界。

四つのボタンを出す。

ページを作る。


クローンしない人に、 一段落を残す

README は構造を持つ。

ハブは、 誰のためかを持つ。

  • 利用者、 スポンサー、 セキュリティ、 記者の四つが、 十二個に増えていないか。

  • 脆弱性の連絡が、 公開の雑談部屋になっていないか。

  • 報奨金が無いなら、 無いと書いてあるか。

  • 企業の請求と、 ファンへの一文が、 一つの「支援」に溶せていないか。

  • ライセンス名と、 保守のみか活発かが、 日付のある文か。

  • ピンしたリポジトリが三つで、 残りは組織へリンクしているか。

  • Discord が一次のサポートになっていないか。

  • 「業界標準」と書いていないか。

クローンしない人のための一段落

利用者にはドキュメントを、スポンサーには請求の経路を、脆弱性には security.md を、記者には短い略歴を置く。
README はクローンする人のもので、ハブはその外側の人のものだ。
一行の説明は重複してよい。
アーキテクチャの全文は重複させない。
Discord を一次の窓口にすると、自分はヘルプデスクになる。
報奨金が無いなら、無いと書く。
「業界標準」とは書かない。
ピンするのは三つまでで、残りは組織のアカウントへリンクする。

GitHub の README はクローンする人に渡し、HTML のハブはそれ以外の人に渡す。
security.md へのリンクを、公開の Discord より上に置く。
URL はリリースのたびに変えない。
変えるのは、保守のみか活発か、という一文の日付だ。

ページを作る — Proは月7€

まずは無料。Proは月額7€。