リポジトリを見える状態にする
リポジトリを公開、活発、かつ非公開の文脈なしに GitHub から評価できる状態に保ちます。
For maintainers
メンテナー向け
Good First Issue があなたのリポジトリにある初心者向け作業を見つけ、評価し、新しい貢献者にとって有用な状態に保てるようにします。
Discovery
リポジトリを索引させる
Good First Issue は現在、公開 GitHub リポジトリとオープンな GitHub Issue を索引します。メンテナーはサインイン後に公開リポジトリを直接送信でき、リポジトリレコードが作成されると Issue クローラーが処理を続けます。
プロジェクトの基本を文書化する
README、CONTRIBUTING、ライセンス、ローカルセットアップ、テスト手順を新しい貢献者が追える程度に明確にします。
リポジトリを送信する
サインイン後に公開リポジトリを送信します。レコードが作成されると、Issue クローラーがオープン Issue を処理します。
Issue labels
初心者向け Issue にラベルを付ける
現在の取得タスクは good first issue と help wanted ラベル付きのオープン GitHub Issue を探します。これらのラベルで見つけやすくなりますが、初回貢献者が安全に動けるだけの文脈も必要です。
最初の pull request がレビューしやすくなる文脈を含める
- Issue がなぜ重要かの背景。
- 具体的な期待結果。
- 最初に見るファイル、パッケージ、プロダクト領域。
- テストコマンドまたは手動検証手順。
- コーディング前に範囲確認が必要かどうか。
Recommendations
推薦品質を上げる
推薦は、リポジトリが活発に保守され、Issue が新しい貢献者でもプロジェクト方向を推測せずに完了できるほど小さいときに最も機能します。
最近のメンテナンス
最近のコミット、返信、トリアージは、レビューがまだ期待できると貢献者が判断する助けになります。
明確な Issue 記述
文脈、受け入れ条件、セットアップノートがある Issue は、新しい貢献者とマッチしやすくなります。
小さくレビュー可能な範囲
低リスクのドキュメント、テスト、UI 改善、小さな bug 修正は、広い設計作業より推薦しやすいです。
健全な貢献ループ
実行可能なテストと応答のあるフィードバックは、放置される pull request を減らし、推薦の質を保ちます。
初心者向けに見えて完了しにくい Issue を避ける
- 最近メンテナーが確認していない古い Issue。
- 所有者やプロダクト方向が不明確な大きな機能。
- 非公開の文脈、認証情報、リリース権限が必要なタスク。
- 再現メモ、セットアップガイド、期待動作がない Issue。
リポジトリを追加しますか？
このページから公開 GitHub リポジトリを送信し、索引済み Issue とフィードバック経路で初心者向け作業の見え方を確認できます。