GitubSession

GITを使用したオープンソースプロジェクトに貢献します

私たちのプロジェクトへようこそ！オープンソースの開発に貢献することを検討していることを楽しみにしています。このガイドは、あなたの貢献を簡単かつ成功させるために、必須のGITコマンドとベストプラクティスを説明します。

目次

1. リポジトリを分岐します
2. リポジトリのクローニング
3. ブランチの作成
4. 変更を加えます
5. 変更を犯します
6. 変更をプッシュします
7. プルリクエストを作成します
8. フォークの同期
9. 良いコミットメッセージを書くためのヒント

---

1。リポジトリのフォーキング

貢献を開始する前に、リポジトリを分岐する必要があります。フォーキングは、独自のGitHubアカウントの下にリポジトリのコピーを作成します。

ステップ：

1. リポジトリページに移動します。
2. 右上隅の[フォーク]ボタンをクリックします。
3. これで、GitHubアカウントにリポジトリのコピーがあります。

---

2。リポジトリのクローニング

リポジトリを分岐した後、それをローカルマシンにクローン化して、作業できるようにする必要があります。

git clone https://github.com/your-username/repository-name.git

---

3.ブランチの作成

リポジトリをクローニングした後、変更に取り組む新しいブランチを作成します。メインブランチとの競合を避けるために、常に別のブランチで作業してください。

git checkout -b feature/your-branch-name

---

4。変更を加えます

支店にいるので、プロジェクトのコード、ドキュメント、または他の部分に必要な変更を加えます。次のステップに進む前に、必ずすべてをテストしてください。

---

5。変更のコミット

変更が完了したら、それをコミットする時が来ました。次の手順に従ってください：

1. ステージング領域に変更を追加します。

git add .

2. 明確で説明的なメッセージで変更をコミットします。

git commit -m " Your descriptive message here "

3. コミットメッセージが行った変更を明確に説明していることを確認してください。

6。変更のプッシュ

変更をローカルでコミットした後、ブランチをGitHubリポジトリに押し込みます。

git push origin feature/your-branch-name

これにより、BranchはGitHubのForkedリポジトリにアップロードされます。

7.プルリクエストの作成

変更をGithubに押し込んだ場合、メンテナーが作業を確認できるように、Pull Request（PR）を提出する準備が整いました。

• GitHubのフォークリポジトリに移動します。
  
• [リクエストの比較とプル]ボタンをクリックします。
  
• タイトルと変更の詳細な説明を提供します。
  
• プルリクエストを送信します。
  
• レビュー後、メンテナーはPRをマージするか、改訂のフィードバックを提供します。
  

8。フォークの同期

作業中に元のリポジトリが更新されている場合は、フォークを同期して最新の状態に保つことをお勧めします。方法は次のとおりです。

1. 上流リポジトリをリモートとして追加します。

git remote add upstream https://github.com/original-owner/repository-name.git

2. 上流のリポジトリから最新の変更を取得します。

git fetch upstream

3. 上流の変更を地元のメインブランチにマージします。

git checkout main
git merge upstream/main

4. 更新されたメインブランチをフォークに押し込みます。

git push origin main

9。良いコミットメッセージを書くためのヒント

• 簡潔に保ちます：50文字未満のコミットメッセージを目指します。
  
• 命令的な気分を使用してください。たとえば、「固定バグ」の代わりに「バグを修正」と書いてください。
  
• コンテキストを提供する：問題番号を含めるか、変更の目的を説明します。
  例：修正＃42-ユーザー認証のバグを解決します。