guideline.md

自習ガイドライン

注意：

• このテキストにはe-Learning動画コンテンツを元にした自習の流れが書かれています。
• GitやGithubの詳細な説明はありません。GitやGithubについては参考資料等をみながら各自調べましょう。
• 各レッスンで課題を出しています。成績には影響しませんが、5/17の講義準備で参考にします。是非提出してください。（超簡単です）

Lesson 1 : 環境を整えよう

1. e-Learning動画コンテンツを入手する

• URLとアカウント情報はmanabaから入手のこと（enPiT履修者限定のため）
• 以下動画を使いながら自習すると良いでしょう

2. Githubのアカウントを作成
3. Gitを使う環境を整える
   • GUI派の皆さん：SourceTreeをインストール
     • Gitが入ってなければインストールされるはず
   • コマンド派の皆さん：ターミナルでGitをインストール

参考資料

• 「Git and Github集中特訓」の動画 (１〜５本目）
  • 動画ではSourceTreeを使うことが前提になっています。

課題

• Githubアカウントをmanabaでお知らせ下さい
  • manabaの課題へのリンク（筑波大生用）
  • manabaの課題へのリンク(参加校生)
  • Github演習のためのグループ（http://github.com/gitpractice-enpit）に追加します

Lesson 2 : ローカルリポジトリを作ってGithubにあげよう

1. ローカルリポジトリを作りましょう
2. ファイルを作って中身を適当に書き、ステージに上げてコミットしてみよう
3. さらに何か書いたり消したりしてコミットしてみよう
4. コミット間の差分を見てみよう
5. Githubでリモートリポジトリをつくり、ローカルリポジトリをリモートにあげよう

参考資料

• 「Git and Github集中特訓」の動画（６〜９本目）
  • Lesson2の1-4までしか解説されてません
  • 5についてはリンク先のページを参考になんかやってみてください。
• Gitコマンド派のLesson2メモ帳

課題

• GithubにあげたリポジトリのURLをmanabaでお知らせ下さい。
  • manabaの課題へのリンク(筑波大生)
  • manabaの課題へのリンク(参加校生)

Lesson 3: リモートリポジトリをフォークしていじろう

1. http://github.com/gitpractice-enpit/practicememo.git をフォークしよう
2. ローカルリポジトリにクローンしよう
3. membersディレクトリの下に<アカウント名>.mdというファイルを追加し、自己紹介を書いてコミットしよう
4. リモートリポジトリにプッシュしよう

参考資料

• 「Git and Github集中特訓」の動画（１０〜１６本目）

課題

• フォークしたURLを教えてください
  • manabaの課題へのリンク(筑波大生)
  • manabaの課題へのリンク(参加校生)

Lesson 4: プルリクエストを送ろう

1. http://github.com/gitpractice-enpit/practicememo.gitにプルリクエストを送ろう

参考資料

• 「Git and Github集中特訓」の動画（１７本目）

課題

• プルリク送ってください
  • プルリクきたらすぐにマージします。そしてcollaboratorに追加します。

Lesson 5: リセットをしてみよう

1. practicememoのローカルリポジトリのファイルをいじってステージに上げてそれをとり消そう
2. practicememoのローカルリポジトリのファイルをいじってコミットしてそれをとり消そう

参考資料

• 「Git and Github集中特訓」の動画（１８本目）

課題

• 特になし

Lesson 6: ローカルでブランチを切ってマージしよう

ブランチの練習ついでにForkしたリポジトリの最新状態を取り込みます。

1. practicememoでdiaryブランチを作ろう
2. diaryブランチにチェックアウトしてdiary/<アカウント名>.mdファイルを作って今日の作業メモを書いてコミットしよう
3. masterにチェックアウトしてfork元のリポジトリをfetchしよう

• え、これ何やってるの？イミワカランという人はこちら

4. masterにdiaryブランチをマージしよう

参考資料

• 「Git and Github集中特訓」の動画（２０〜２２本目）

課題

• マージし終わったリポジトリをfork元にプルリクしよう

Lesson 7: Fork使わないプルリクをしよう

前提

• practicememoリポジトリのcollaboratorに追加されていること。
• されていなかったらご一報ください。

注意

• この辺からSourceTreeでの操作方法を書いていません。
• 下記の手順に該当する操作方法でわからないところがあったら、調べるかIssueで質問してください。

手順

1. practicememoのmasterブランチでpullしよう
2. <アカウント名>_ブランチを作ってチェックアウトしよう
3. diary/<アカウント名>.mdファイルを編集してステージに上げてコミットしよう
4. <アカウント名>_ブランチをプッシュしよう
5. Githubサイト上でプルリクエストを送ろう

参考資料

• https://b.pyar.bz/blog/2014/01/22/github-flow/

課題

• プルリクエスト送ってください（つまり上記の5.をやってください）

Lesson 8: プルリクされたものをレビューしよう

1. https://github.com/gitpractice-enpit/practicememo のpull requestメニューを見てみよう
2. 差分を見てコメントをしてみよう。
3. プルリクされたリモートブランチをローカルに持ってきてmasterにマージして見てみよう

• そこで何か気がつけばコメントをしてください。

4. マージして良さそうなものにマージOKのコメントをつけましょう。

課題

• practicememoの誰のpull requestにどんなコメントをしたかmanabaに報告しましょう。
  • manaba課題へのリンク(筑波大生用)
  • manaba課題へのリンク(参加大生用)

Lesson 9: プルリクされたものをマージしよう

1. practicememoのpull requestリストからマージするものを選びましょう
   • 誰かコードレビューでOKが出ているものを選びましょう。
   • コードレビューされていなければ自分でレビューしましょう。
2. ローカルリポジトリ上でマージして動作レビューしましょう。
   • 最新のmasterを持ってくる
   • プルリクエストされたブランチをfetchしてくる
   • マージして動作を確認する
   • マージできない状態でしたら、コメントしましょう
3. リモートリポジトリ上でマージをしましょう
   • GithubのWebページ上でマージをするか、ローカルリポジトリでmergeしたものをpushしましょう
   • プルリクエストをクローズしましょう。（マージしたら自動クローズされるかも）

課題

• マージしたプルリクエストの情報をmanabaに報告しましょう。
  • クローズしたpull requestのURLを貼ってください。
  • manaba課題へのリンク（筑波大生用）
  • manaba課題へのリンク（他大生用）

参考資料

• 書籍「GitHub実践入門」の第７章 「Pull Requestが送られてきたら」

Lesson 10: Issueを使ってみよう

• GithubのWebページのIssueは、リポジトリで管理されているプロダクトに関しての問題や課題を管理するところです。プロダクトに関しても問題やこれから追加してほしいことなどがあればIssueに書きましょう。
• チーム開発のタスク管理をIssueを使って行うと、情報が一元化できます。（参考資料を参照）

手順

1. gitpractice-enpitまたはpracticememoのIssueに何か希望等を書き込んでみましょう。

課題

• Issueの記録（どのリポジトリに何のIssueを投げたか）をmanabaに報告しましょう。
• manaba課題へのリンク（筑波大生用）
• manaba課題へのリンク（他大生用）

参考資料

• 開発者のタスク管理をGithubで行ったらうまくいった話(Developers.IO)

Lesson 11: Issueを解決してみよう

（近日公開予定）