最初のPRを作成するための簡単なチュートリアル（プルリクエスト）

まあ、これはかなり短いチュートリアルであり、うまくいけば教訓的だと思うならこれです;）。 githubで小さなリポジトリを利用できるようにして、PRを送信できるようにすると同時に、以下に残すすべての手順を実行する方法を練習できるようにします。 テストPRを行うためのリンクは次のとおりです。

https://github.com/CodeLabora/TuPrimerPR

さて、PRを送信するために必要な手順を簡単にリストしましょう：

1. フォーク
2. クローン
3. リモート
4. ブランチ
5. 変更
6. Add
7. コミット
8. プッシュ
9. PR

gitコマンドラインでそれぞれのオプションが見つかるように、英語で入力しています。

フォーク

フォークは、Githubリポジトリの独自のバージョンです。 これにより、別のプロジェクトの作業を複製してアカウントに含めることができるため、変更を失うことを心配せずに変更を加えることができます。 フォークを作成するには、ページに移動して、右上にある[フォーク]ボタンをクリックするだけです。

フォークが完了すると、リポジトリがアカウントに表示されます。

クローン

リポジトリができたので、それをチームに複製します。 （Linuxを使用している人が私をフォローしていると思いますが、他のシステムのユーザーのために、公式ページからダウンロードできるバージョンのgitもあります。

そして、私たちの端末では、次のことを行います。

これにより、Githubプロジェクトが配置されるTuPrimerPRという新しいフォルダーが作成されます。 コマンド«cdTuPrimerPR»を使用してフォルダーに入ると、フォーク内にあるファイルが内部にあることがわかります。

（ファイルの数は、フォークしたときにリポジトリで見つけたものによって異なる場合があることに注意してください）

リモート

これはオプションの手順ですが、プロジェクトで継続的に作業する場合の多くの問題を回避できます。 Forkはデフォルトでリポジトリの正確なコピーを作成しますが、作成の正確な瞬間に作成します。 これは、プロジェクトが進行し続けると、リポジトリが数日または数時間の経過で遅れることを意味します。 「Gitremote」を使用すると、別のダウンロードポイント（元のプロジェクト）を指定できるため、親プロジェクトが更新されていることを確認するたびにプロジェクトを更新できます。

親プロジェクトを見つけるには、リポジトリの名前のすぐ下にあるリンクを使用する必要があります。 （フォークセクションのXNUMX番目の画像を確認してください）。 この情報を以下に追加します。

これは元のプロジェクトです（これを呼びます） アップストリーム 多くのプロジェクトについていくために）。

ご覧のとおり、»git remoteaddを使用してリモートを追加しました»»

これにより、必要に応じてプロジェクトを更新することができますが、必要がないため、現在は使用しません。 （必要に応じて、後で、または別の投稿で説明します）

ブランチ

ブランチ（または複数のブランチ）を使用すると、分離された環境で作業できるコードのセクションを作成できます。 つまり、ブランチで行うことは、»gitmerge«が使用されるまで元のコードに必ずしも影響を与えません。 また、Githubで使用できる追加機能でもあり、ブランチを作成するたびに、Githubは必要に応じてプルリクエストのソースを自動的に生成します。

私たちは特別な支部にいるので、貢献に取り組むことができます。

変更

それがどのように行われるかを確認できるように、いくつかのファイルを追加します。

「タッチ」を使用すると、空のファイルを作成できます（ファイルが存在しない場合）。 これで、次のステップに進むことができます。

Add

»gitadd»を使用すると、コミットにファイルを追加できます（後で説明します）。 追加できるファイルを確認するには、コマンド»gitstatus»を使用できます。

これで、コミットの準備が整いました

コミット

コミットは、時間のマーク（またはマイルストーン）です。 プロジェクト内のすべてのファイルの状態を定義し、プロジェクトの開始から現在の状態に到達するために必要な変更を蓄積します。 少し複雑に聞こえますが、非常に単純です。プロジェクトの階段であることを忘れないでください。 »gitcommit»と書くと、コミットメッセージを書くためのウィンドウが表示されます。

最後にテキストを保存すると、次のように表示されます。

コミットが行うことの要約が表示される場所。

プッシュ

プッシュを使用して、インターネット上のリポジトリにない、コンピューター上にあるすべてのコミットをGithubアカウントにアップロードします。 これにより、Githubが新しいPRを自動的に生成できるようになります。

ブランチの名前を使用しており、ユーザー名とパスワードの入力を求められていることに注意してください。 最後に、myImprovementブランチがGithubアカウント内に作成されたことを示しています。 ブラウザで何を達成したか見てみましょう。 😉

PR

ご覧のとおり、「Compare＆Pullrequest」という新しい行が作成されています。 このGithub機能を使用すると、簡単な方法でPRを作成できます。クリックして、何が起こるかを確認します。

Githubはかなりスマートです。 ご覧のとおり、コミットの一部が送信用のフォームに追加されています。 ボタンをクリックするだけで、それだけです。🙂シンプル。

余分

これはプロジェクトの舞台裏であり、PRが表示され、マネージャーは受け入れるかどうか、またはさらにメッセージを書き込むかどうかを決定します。 私の場合、すぐに受け入れます。

マージが完了すると、プロジェクトのコミットログとその中の名前を確認できるようになります。

しかし今、私たちは問題を抱えています。 そのコミットはに表示されません 私たちの プロジェクト内のリポジトリのみ。 私たちの遠い通路を覚えていますか？ 今が報われる時です🙂

マスターブランチに戻り、次の手順を実行します。

これで、元のプロジェクトのすべての情報をチームにダウンロードしました。 ご覧のとおり、コミットが表示されます。 次に、このすべての作業をGithubリポジトリに保存して、プロジェクトにすでに追加されている貢献があるブランチを削除できるようにします。

更新されたGithubリポジトリができたので、ブランチを削除しますが、最初に、メインブランチ（マスター）内にあることを確認します。

ご覧のとおり、わずかなエラーが発生しました。これは、削除したいときにmyImprovementブランチにいたためです。 これは、マスターブランチに戻ることで修正されます。

結論

完了🙂それと同じくらい簡単です。 PRを送信するためのGithubの暗い秘密をマスターしたので、さまざまなプロジェクトへの貢献を楽しみにしています。 そして、必要に応じて、最初のPRを私のリポジトリに残しておくことができます😉覚えておいてください。

私は千と一のGitの利点に触れていません（EYE、Githubではありません）そしてカーネルコミュニティに縛られている開発者に期待されるように、Gitは何百もの機能を備えた非常に強力なツールです。

それが何をするのか、そしてGitのすべての力をよりよく理解するために、私はこれを強くお勧めします ブック。 gitの処理を改善するのに大いに役立つと確信しています。

ご挨拶と私はそれがあなたを助けることを願っています😉