Your first contribution

[github-learning-lab]

GitHubフローの紹介

さてイシューに慣れてきたところで、このイシューを使ってあなたの初めてのコントリビュートの道筋をたどってみましょう。

プロジェクトによってコントリビュートのフローは異なりますが、GitHub上で最もシンプルで最も効率的なコントリビュートのやり方はGitHubフローです。

📺 ビデオ：GitHubフローを理解する

---

以下を読み進めて、次のステップに移りましょう

[github-learning-lab]

ステップ４：ブランチを作ろう

GitHubフローの最初のステップに取り掛かりましょう：つまりブランチの作成です^📖。

ブランチの作成

ブランチの作成

📺 Video: Branches

さて、GitHubフローの最初のステップとしてブランチの作成方法を学びました。

ブランチを作ることによってmasterブランチからあなたの作業を分離することができるため、ブランチはGitHubフローにおいて重要な役割を果たします。言い換えれば、誰もが安全な場所でコントリビュートを始めることができるのです。

ブランチを使う際のコツ

１つのプロジェクトの中にブランチは何百と作成され、それぞれがmasterブランチへの変更の提案となります。

これらのブランチをチーム全体で管理可能な状態を保つには一つ一つのブランチを完結で短命に保つことが必要です。言い換えると、１つの新しい機能か１つのバグフィックスごとに１つのブランチを作成するべきです。こうすることで、ブランチがmasterブランチにマージ ^📖 されるまでのアクティブな期間を数日に保つことができ、他のコントリビューターが混乱する可能性を減らすことが出来ます。

---

⌨️ やってみよう：初めてのブランチ

1. Codeタブに移動しましょう
2. Branch: master ドロップダウンをクリックしましょう
3. 入力フィールドに、例えばmy-slideのように、作成するブランチの名前を入力しましょう
4. Create branch: をクリックするか、"Enter"キーを押し、ブランチを作成しましょう

---

このリポジトリで新しいブランチが作成されたら、新しいコメントを書き込みます。

[github-learning-lab]

ステップ５：ファイルをコミットしよう

🎉 ブランチを作成できました！

ブランチを作成することで、masterブランチに変更を加えることなくプロジェクトへの修正を行うことができるようになります。さて、ブランチの作成が完了したので、次はファイルを作成し、初めてのコミットを行いましょう！

コミットの基礎

コミットの基礎

GitHub上で新しいファイルを作成したり、ファイルの修正をし終えたら、ページの下にスクロースしましょう。"Commit new file"セクションが見つかるはずです。

最初のフィールドにはコミットメッセージを入力します。コミットメッセージでは、このファイルに対して行った変更を他の人に完結に伝える必要があります。

コミットメッセージを書く際の決まり：

• コミットメッセージの終わりにピリオドは付けない
• コミットメッセージは５０文字以内とする。必要であれば、詳細な情報は追加の詳細フィールドに記載する。これはタイトルのラインのすぐ下にあるフィールドです
• 現在形を使う。例えば、「追加した」の代わりに「追加する」を書いたり、「マージした」の代わりに「マージする」と書く
• ファイルを変更する上での意図を書く

---

⌨️ やってみよう：初めてのコミット

下記の手順に従うことによって、GitHub上に変更をコミットすることが出来ます。

1. このブランチに新しいファイルを作成しましょう。_postsフォルダーに0000-01-02-borinok.mdという名前のファイルを作成します。このリンクをクリックするか、以下の手順でファイルを作成することが出来ます：
   • "Code"タブに戻る
   • ブランチドロップダウンにて、"my-slide"を選択
   • Create new fileをクリック
   • "file name"フィールドに_posts/0000-01-02-borinok.mdと入力する。ファイル名の中に/を入れることで自動的にそのファイルを_postsディレクトリに保存することが出来ます。
2. ファイルの名前を入力したら、以下の内容をファイルに追加する：

   ---
   layout: slide
   title: "２枚目のスライドにようこそ！"
   ---
   何かを書く。
   戻るには戻るボタンを使いましょう！

3. テキストを追加後、ファイル編集ビューのすぐ下にあるテキスト入力フィールドにコミットメッセージを入れることで、この変更をコミットすることが出来ます。コミットメッセージのガイドラインとしては、手順のすぐ上にあるコミットの基礎を参照してください。
4. コミットメッセージを入力したら、Commit new fileをクリック

---

このブランチに新しいコミットが行われたら、追加のコメントを書き込みます。