「初心者向け」GitHub運用③：Issueを作ってみる

# この記事はこんな方向けです！
**細かいことは置いといて**
・GitHubの基本的な使い方を知りたい!
・GitHubでのチケットベース開発を知りたい！
・Slackと連携の取り方を知りたい！

そんな方への**手っ取り早いハウツーな記事**です

# この記事を読み終えますと、

**OrganizationのProjectベースで、
Milestoneを通したIssue管理ができるようになります。**

# いくつか記事を分けます

本記事では**「Issueを作ってみる」**についてです。

基礎
1. [OrganizationとTeamを作ってみる](https://qiita.com/kotaro_bayashi/items/dd70fbf14b8bf43143a9)
2. [Projectを作ってみる](https://qiita.com/kotaro_bayashi/items/aa62989350c4367caa60)
3. **Issueを作ってみる**
4. [他人を招待し、権限付与](https://qiita.com/kotaro_bayashi/items/76a7fd5e5b70b1d04183)

応用
5. [Hubotを使ってみよう〜Heroku自動デプロイまで](https://qiita.com/kotaro_bayashi/items/f82db9620643d0430d0d)
6. [HubotとSlackを連携](https://qiita.com/kotaro_bayashi/items/26ec3ff24a41fa942190)

# 1 Projectの画面から,Issueを作る
ここまでに作成したProjectの画面で、Noteを作り、Issueに変換します。
※Repositoryの画面からIssueを直接作ることもできます。

**まず、Noteを作ります。**

- 「+」をクリック
- テキストエリアに内容を記入し、「add」をクリック　　　　　　　　　　
![addNote.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/3791c213-2713-b17e-91bb-378b0dd1b2ba.jpeg)

**NoteをIssueに変換する**

- 作成したNoteの「・・・」をクリック
- 「Convert to Issue」をクリック　　　　　　　　　　　　　　　　　　　　　　　
![toIssue.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/9b038c88-6995-592a-e7cb-aafddde11adc.jpeg)

- Repositoryを選択
- Bodyに内容を記入
- 「Convert to Issue」をクリック
![issue.jpeg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/e40ebef5-bdbd-cfbd-1a49-86e617bef7f9.jpeg)


# 2 作成したIssueの設定を行う
- Projectの画面で、作成したIssueの名前部分をクリック
- 画面の右端から設定パネルが表示されます。

![setIssue.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/f27fcc9b-a7da-0f45-af1f-13e6e932e0b6.jpeg)

**緑の確固部分を設定していきます。**

**Assignees、Labels付与**

- 担当者を決める　※現状ではご自身だけですが、後ほど増えます
- どういう種類なのかわかりやすくるため、labelを付与する

**Milestoneを設定**

これは期限を設定するモノです。
しかし、Project画面からでは、Milestoneを作成することはできないです。

``RepositoryのIssues画面でMileStoneを作り、
その後、Project画面からIssueにMilestoneを設定します。``

- RepositoryのIssues画面を開きます。
- 「MileStones」をクリック
![toMileStone.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/4ffcd5b2-9398-6b6e-b82c-f7e625bca0ac.jpeg)

- 「new Milestone」もしくは「create A Milestone」をクリック
- タイトルと期限を入力し、「Create Milestone」をクリック
- Project画面に戻り、先ほど作成したMilestoneを紐つける

# 3 Projectの挙動を確認する

右にある緑バー。これがProject全体の進捗です。
このバーが左右一杯になると、Projectは完了しているということです。

![step1.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/cbbd7179-317f-4b26-b1cf-77125642ab6d.jpeg)


**現状では、完了していないですが、作成したIssueを一番右端まで進めますと、完了したことになります。**
![step2.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/0c89e9e4-ccbe-1cfb-eaa4-2eb6c2e415b9.jpeg)

# 4 Milestoneの挙動を確認する
Project上では完了していますが、**Milestone上では未完了です。**

Milestoneを確認しますと... 「0% complete」となっておりまして、未完了ですね。
![step3.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/65128386-e091-f36a-18b9-899aab9904dd.jpeg)

**Milestoneを完了させるには、Milestoneに紐ついているIssueをcloseする必要があります。**

- Project画面に戻りまして、Issueの「close issue」をクリック ※「Go to issue to full details」→「close issue」でも可

![step4.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/b0782ccb-4f97-06c7-57e0-7e135b1fc1a2.jpeg)

そうすると...
![step5.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/534534/b02abbb4-9c82-2c48-ffa3-c07b71b48dfa.jpeg)

**Milestoneも完了！**

# まとめ

これで、ProjectベースでIssueの進捗をまとめて管理ができる様になり、
さらにMilestoneを使って時間軸でも管理できるようになったと思います。

複数のIssueを一つのMilestoneに紐つけると、管理しやすくなります。
「Pull RequestをIssueに紐つける、Pull Request承認後に自動Close」といった設定をすると
さらに管理しやすくなると思います。

これまで、アカウントは１つで進めてきましたが、
次回は、複数アカウントでProject管理を行っていきましょう！