初心者チーム開発 - 課題１

前提条件

使用するリポジトリのクローンができている状態。

クローンできていない場合はコチラの動画を参考にしてください。

※動画で使っているリポジトリは一例です。チームリーダーが作成したリポジトリを使用してください。

チームリーダー向けイベントではコチラのリポジトリを使います。→https://github.com/recursion-git-work-shop/task1

手順

1. リポジトリのURLを取得
2. vscodeの「Gitリポジトリのクローン」を使用

2023-03-09.3.15.13.mov

---

1. スタートとゴール

メンバー全員が順番にリモーリポジトリからローカル環境のindex.htmlに文章を追加し、下記のような成果物を作成することと、Issueやpull requestなどのGitHubの機能、またgit add .などのGitコマンドを覚えることが目標。

スタート

ゴール

---

2. 開発の流れ

概要

初心者チーム開発で使用するgitをハンズオンで解説します、主な流れとしては:

1. Issueを作って自分のタスクを登録する
2. developブランチにてgit pullを実行
3. git switch -c ブランチ名で追加機能用のブランチを作成、移動
4. 追加機能作成
5. git add .で修正したファイルをgitに指示する（ステージング）
6. git commit -m "変更内容に関するメッセージ"でステージングしたファイルの内容をgitに指示する
7. git push origin ブランチ名でリモートリポジトリへ一連の作業内容を保存
8. developブランチへプルリクエストを作成する
9. プルリクエストに対するレビューをしてもらう
10. developブランチへマージする

2.1 - Issueを作って自分のタスクを登録する

2.1.1 - Isuueとは

Isuueとは開発メンバー間で共有が必要な事項をスレッド形式で立てられる機能です。

各Issueには、Issueとその重大度を識別するのに役立つタイトル、説明、およびラベルを付けることができます。 GitではIssueにコメントを追加することもできます。これを使用して、考えられる解決策について議論したり、追加情報を提供したりできます。

問題が解決したら、それをクローズして、問題を修正するために加えた変更をリポジトリにコミットできます。

Issueの詳しい説明はコチラ（ドキュメントのリンク） 参考リンク

• Issueの作成方法
• Issueで課題管理Assignee, Label, Project機能
• Markdown記法の書き方1
• Markdown記法の書き方2

2.1.2 - 手順

作成の手順　　

2023-03-08.2.29.49.mov

closeの手順

2023-03-08.2.23.57.mov

2.2 - developブランチにてgit pullを実行

2.2.1 - git pull の説明と具体例

git pullとは、リモートリポジトリから最新の状態をローカルリポジトリに反映するコマンドです。

例えば、Red Teamが「Hello Red Team」をindex.htmlに追加し、developブランチにマージしたとします。 そうするとRed Teamとそれ以外のチームで差異が生じます。

Red Teamのブラウザ

それ以外のチームのブラウザ

2.2.2 - 手順

※注意developブランチにいない場合git switch developでdevelopブランチに戻る必要があります。

2.3 - git switch -c ブランチ名で追加機能用のブランチを作成、移動

2.3.1 - git switch -c ブランチ名の説明

-cはgitのコマンドに用意されたオプションであり、createのcです。このオプションでブランチの作成を行っています。 要するに下記の作業を一回のコマンドで行っています。

git branch <new-branch>
git switch <new-branch>

2.3.2 - 手順

作業ブランチの名前は具体的な作業名にするのが通例です。 Blue Teamがindex.htmlに修正を加えるとします。

2.4 - 追加機能作成

2.4.1 - 手順

Blue Teamがindex.htmlに挨拶を加えるとします。

2023-03-08.3.18.00.mov

2.5 - git add .で修正したファイルをgitに指示する（ステージング)

2.5.1 - git addの説明

git addコマンドは、Gitのステージングエリアに変更を追加するために使用されます。言い換えれば、次のコミットにどの変更を含めたいかをGitに伝えるために使用されます。

git add path/to/fileで特定のファイルをステージングエリアに追加できます。

git add .でディレクトリ配下の全てのファイルの変更をステージングエリアに追加できます。

2.5.2 - 手順

git add .を使います。

2.6 - git commit -m "変更内容に関するメッセージ"でステージングしたファイルの内容をgitに指示する

2.6.1 - git commit -m "変更内容に関するメッセージ"の説明

git commitコマンドは、ローカルリポジトリへの変更を記録するためにGitで使用されます。言い換えれば、2.5で使用したgit addコマンドでステージングしたファイルの内容を記録しているということです。

-mオプションを使用すると、行った変更を説明するメッセージを含めることができます。

2.6.2 - 手順

2.7 - git push origin ブランチ名でリモートリポジトリへ一連の作業内容を保存

2.7.1 - git push origin ブランチ名の説明

git pushコマンドは、Gitリポジトリに加えられたローカルの変更をリモートリポジトリにアップロードするために使用されます。言い換えれば、2.5、2.6で行った作業をローカルからリモートリポジトリに反映させています。

originとはリモートリポジトリのアクセス先に対してGitがデフォルトでつける名前です。言い換えれば、みなさんがリポジトリをクローンするために使ったURLの内容をoriginとしています。

2.7.2 - 手順

2.8 - developブランチへプルリクエストを作成する

2.8.1 - プルリクエストの説明

プルリクエスト(PR)は、作業で行った変更がリポジトリのメインブランチにマージされる前に、開発者がプロジェクトの変更を提案し、フィードバックを取得できるようにするGitの機能です。

2.8.2 - 手順

①画面中央、compare pullrequestをクリック

②画面左、reviewerを設定

③画面左、assigneesを設定

2.9 - プルリクエストに対するレビューをしてもらう

2.9.1 - レビューの説明

レビューとはプルリクエストに対してチャットベースで行うことができるGitの機能です。 チームメンバーは、変更を確認し、問題を共有し、リモートリポジトリに統合される前に問題を改善できます。

2.10 - developブランチへマージする

2.10.1 -　手順

①緑色の枠で囲まれた範囲にある、merge pull requestをクリック。

②紫色の枠で囲まれた範囲にある、delete branchをクリックし、使用したブランチをリモートリポジトリ上から削除する。

---