はじめてのPRチュートリアル

contributors.json にあなたのエントリを追加するだけ！最初のPull Requestを作成しましょう。

必要なもの

  • ✓GitHub アカウント（github.com で無料作成できます）
  • ✓ブラウザ（これを読んでいるなら準備OK）

※ Gitのインストールは不要です。すべてブラウザ上で完結します。コマンドラインで操作したい方向けに各ステップの最後に補足を載せています。

1

Step 1リポジトリをForkする

まず、Git Training Ground のリポジトリを開きます。

右上の「Fork」ボタンをクリックし、次の画面で「Create fork」をクリックしてください。

リポジトリ右上の Fork ボタン
Create fork ボタンをクリック

Forkとは？
リポジトリの個人コピーを自分のアカウントに作ることです。元のリポジトリには影響しないので、安心して作業できます。

2

Step 2contributors.json を開く

Forkしたリポジトリ（自分のアカウントの git-training-ground）で、data/contributors.json を開きます。

ファイル一覧から data フォルダ → contributors.json の順にクリックしてください。

data フォルダを開く
contributors.json を選択
コマンドラインで操作したい方へ

Fork したリポジトリを自分の PC にクローンして編集することもできます。

bash
git clone https://github.com/<yourname>/git-training-ground.git
bash
cd git-training-ground

<yourname> は自分の GitHub ユーザー名に置き換えてください。

3

Step 3編集モードに入る

ファイルを開いたら、右上の鉛筆アイコン（Edit this file）をクリックします。

Edit this file の鉛筆アイコン

編集画面が開き、直接ファイルを書き換えられるようになります。

コマンドラインで操作したい方へ

作業用ブランチを作成してから編集します。<yourname> は半角英数字のハンドル名に置き換えてください（ひらがな・漢字・空白は不可）。

bash
git switch -c add-<yourname>

例: git switch -c add-oginochihiro

その後、お好きなエディタで data/contributors.json を開きます。

4

Step 4自分のエントリを追加する

下のコードをコピーして、ファイルの配列末尾に貼り付けるだけ！

① 以下のコードをそのままコピーしてください（先頭の ,（カンマ）も必要です）:

  ,
  {
    "name": "あなたの名前",
    "github": "your-github-handle",
    "favoriteColor": "#FF5E5B",
    "favoriteEmoji": "🦊",
    "message": "よろしくです！",
    "joinedAt": "2026-04-24"
  }

② 貼り付ける位置: 配列の最後のエントリの } の直後、] の直前。

カーソル位置: 最後のエントリの } の直後

③ 貼り付けたら、自分の情報に書き換えます。変更後はこんな感じになります:

[
  {
    "name": "ketts",
    "github": "t0k0shi",
    "favoriteColor": "#E63946",
    "favoriteEmoji": "🚀",
    "message": "はじめてのOSS貢献！",
    "joinedAt": "2026-04-24"
  },
  {
    "name": "oginochihiro",
    "github": "https://github.com/oginochihiro",
    "favoriteColor": "#FF5E5B",
    "favoriteEmoji": "🦊",
    "message": "よろしくです！",
    "joinedAt": "2026-04-24"
  }
]
貼り付け後のエディタ

各フィールドの意味

name — 表示名（ハンドルネーム可）

github — GitHub ハンドルまたは URL

favoriteColor — カードボーダー色（#RRGGBB 形式）

favoriteEmoji — 1 文字の絵文字

message — 1 行自己紹介

joinedAt — PR を出す日付（YYYY-MM-DD）

参考になるサイト

⚠️ 注意: 他の人のエントリは消さないでください。 コピペしたコードの先頭の , は必ず残してください（JSON の構文ルール）。

5

Step 5変更をコミットする

編集が終わったら、ページ右上の「Commit changes...」ボタンをクリックします。

Commit changes... ボタン

Commit message: Add <yourname> to contributors（<yourname> は自分のハンドル名に置換）

選択: 「Create a new branch for this commit and start a pull request」を選ぶ

ブランチ名: add-<yourname> のように設定（例: add-oginochihiro）

新しいブランチを作成する選択画面

ブランチ名の注意: 半角英数字とハイフンのみ使用してください。ひらがな・漢字・空白は使えません。

「Propose changes」をクリックしてコミットを完了します。

⚠️ Forkにコミットしただけでは反映されません！
この操作で自分のForkリポジトリにコミットされますが、 本家リポジトリにはまだ反映されていません。 次のStep 6で「Pull Request」を作成して、はじめて本家に反映のリクエストが送られます。

コマンドラインで操作したい方へ

ローカルで編集した場合、以下のコマンドでコミット・プッシュします:

bash
git add data/contributors.json
bash
git commit -m "Add <yourname> to contributors"
bash
git push origin HEAD
6

Step 6元のリポジトリからPull Requestを作成する

コミット後、元のリポジトリ（t0k0shi/git-training-ground）を開いてください。

ページ上部に黄色いバナーで「Compare & pull request」ボタンが表示されます。これをクリックしてください。

Compare & pull request バナー

⚠️ 重要: 必ず元のリポジトリ（t0k0shi/git-training-ground）側から操作してください。自分のFork内で操作すると、PRの送り先が自分のForkになってしまいます。

バナーが表示されない場合は？
時間が経つとバナーが消えることがあります。その場合は自分のForkページで「Contribute」→「Open pull request」をクリックするか、「Pull requests」タブ →「New pull request」→「compare across forks」から、base を t0k0shi/git-training-ground、compare を自分のフォークのブランチに設定してください。

コマンドラインで操作したい方へ

GitHub CLI (gh) があれば、ターミナルから PR を作成できます:

bash
gh pr create --repo t0k0shi/git-training-ground --title 'Add <yourname> to contributors' --body ''
7

Step 7PRの内容を確認して送信する

「Open a pull request」画面が表示されます。base が t0k0shi/git-training-ground になっていることを確認してください。

Open a pull request 画面（base の確認）

Title: Add <yourname> to contributors（コミットメッセージが自動入力されます）

Description: 空欄でもOKです

内容を確認して「Create pull request」をクリックしてください。

8

Step 8CIチェックを待つ

PRを作成すると自動テスト（CI）が実行されます。

CI チェックの実行画面
  • contributors.json の形式チェック（必須フィールド・favoriteColor 形式・重複ハンドルなど）
  • 既存エントリが削除されていないかチェック
  • 1 PR で 1 エントリのみ追加しているかチェック

すべてのチェックがパスするのを待ちましょう。もしエラーが出たら、エラーメッセージに従って修正してください。

9

Step 9マージを待つ

メンテナーがレビューし、問題なければマージされます。おめでとうございます！

PRを出した後に「コンフリクト」と表示されたら？

コンフリクトについて →

コンフリクトが起きたら

PRを出した後に「コンフリクトがあります」と表示されることがあります。 これは、あなたが作業している間に他の人の変更がマージされたためです。

心配しないでください！

管理人がマージ時に調整しますので、そのまま待っていれば大丈夫です。

「自分で直してみたい！」という方は、以下の手順を試してみてください。 （やらなくても大丈夫です）

Step Aupstream を登録する

fork 元のリポジトリを "upstream" として登録します。

bash
git remote add upstream https://github.com/t0k0shi/git-training-ground.git

Step Bupstream の最新を取得する

upstream の最新変更を自分のブランチに取り込みます。

bash
git fetch upstream
bash
git merge upstream/main

Step Cコンフリクトを解決する

コンフリクトマーカー（<<<<<<<, =======, >>>>>>>）を削除して、自分のエントリと他の人のエントリの両方を残します。JSON のカンマの位置にも注意してください。

変更前（コンフリクトマーカーあり）:

[
  {
    "name": "ketts",
    "github": "t0k0shi",
    ...
  },
<<<<<<< HEAD
  {
    "name": "自分",
    "github": "me",
    ...
  }
=======
  {
    "name": "他の人",
    "github": "you",
    ...
  }
>>>>>>> upstream/main
]

変更後（両方のエントリを残す）:

[
  {
    "name": "ketts",
    "github": "t0k0shi",
    ...
  },
  {
    "name": "他の人",
    "github": "you",
    ...
  },
  {
    "name": "自分",
    "github": "me",
    ...
  }
]

Step D解決をコミットして push する

解決した変更をコミットして push します。

bash
git add data/contributors.json
bash
git commit -m "resolve conflict"
bash
git push origin HEAD

これでPRのコンフリクトが解決されます！

うまくいかなかった場合はコメントで質問してください。管理人がサポートします。

PRがマージされたら...

おめでとうございます！あなたのカードがトップページに表示されます。

トップページを見る

よくある質問