海外Webサービスの使い方を「日本語で」分かりやすく説明するシリーズ、今月は「GitHub(ギットハブ)」でissueの投稿に使える裏ワザを紹介します。
チーム開発の際に便利なWebホスティングサービス「GitHub(ギットハブ)」。以前4回にわたってGitHubの基本操作を紹介しましたので、今回はサービスを使いこなし「上級者」に一歩近づくための「issue(イシュー)」の便利なTipsを紹介します。
※各固有名詞の読みはユーザーによって異なるため、一つの参考としてください。
issueは、開発メンバー間で共有が必要な事項をスレッド形式で立てられる、掲示板形式の連絡機能です。これを活用すると、開発者とマネージャーがプロジェクトの進捗状況について容易にコミュニケーションを取れます。
「ラベル」は、issueをカテゴリ分けするためのツールです。無数に投稿されるであろうissueを各カテゴリにひも付けて分別するのにとっても便利です。
ラベルの作成方法
issue画面の左上にある「Labels」をクリックします。
ラベル画面に遷移し、作成済みのラベルが一覧表示されます。
ラベルの新規作成は右上の「New Label」を、既存のラベルを修正もしくは削除したい場合には、当該ラベル列右端にある「Edit」「Delete」をクリックします。
「New Label」をクリックすると、画面上部に入力欄が現れます。ラベル名を入力し、色を設定して「Create Label(ラベルを作成)」をクリックすると、ラベルを確定します。とっても簡単ですね!
作成したラベルは一覧の最上列に表示されます。
後は、該当するissueにラベルをひも付けるだけです(ひも付けは、各issueの画面で設定できます)。
次に、issueを絞り込む際にとても便利な「マイルストーン」を紹介します。
マイルストーンは、鉄道や道路などで起点からの距離をマイルで示した「距離標識(里程標)」のことです。そこから転じて、開発プロジェクトの進捗管理で「節目」として設けられる時間的地点のことを指すようになりました。
マイルストーンの作成方法
ラベル作成時同様、issue画面の左上にある「Milestones」をクリックします。
マイルストーン画面に遷移し、作成済みのマイルストーンが一覧表示されます。
マイルストーンを新規作成する場合は、右上の「New milestone」を、既存のマイルストーンを編集、クローズ(当該マイルストーンにひも付けられたissueが全て対応済みのとき)、削除する場合には既存列右端の「Edit」「Close」「Delete」をそれぞれクリックします。
こちらが新規作成画面。マイルストーンのタイトルと説明、期間を指定して「Create milestone」をクリックすれば完了です。その後ラベルと同じように、issueの編集画面でマイルストーンをひも付けます。
マイルストーンで絞り込んでissueをソートすれば、「いつまでに何をやらなければいけないのか」が一目瞭然になり、非常に役立ちます。
アサインの意味はご存じの通り、「人を指名する、割り当てる」です。issueを「この人に担当してもらいたい」という意思表示を行うための機能です。
アサイン対象になるのは、同じリポジトリを閲覧できるチームの面々のみ。issue作成時、または既存issueの編集画面で設定できます。
アサイン方法
「Assign someone to this issue(このissueに担当者を割り当てる)」をクリックし、表示されるチームメンバーの一覧から割り当てたい担当者を選択します
アサインが完了すると、そのユーザーの名前がissue画面に表示されます。
これで全て完了。保存ボタンなどをクリックする必要はありません(ラベル、およびマイルストーンをひも付けた場合でも同じです)。なお、一つのissueにつきラベルは複数適用できますが、マイルストーンとアサインはそれぞれ一つのみなのでご注意ください。
issueの一覧画面では「Author(issueを作成した人)」「Labels(ラベル)」「Milestones(マイルストーン)」「Assignee(担当者)」、および「issueの状態」でソートをかけられます。これで何十、何百とあるissueも効率よく管理できますね(デフォルトは「オープン」×「日付昇順」でソートされています)。
issueの状態には、「日付降順」「日付昇順」「コメント最多」「コメント最小」「更新日付降順」「更新日付昇順」(画面上から順に)があります。
携帯電話のメールなどで日常的に使用するあの絵文字たちが、GitHubで使えることはご存じでしたか?
では早速、issueに絵文字を書き込んでみましょう。
コメントエリアにコロンを打ち込むだけで、絵文字のオートコンプリートも可能です。これは使うしかないですね。
通常のissue作成をマスターしたあなたに、より速くissueを完成させられるショートカット機能を紹介します。「GitHub Help」の当該ページから三つ解説しましょう。
「issue番号」「リポジトリ内のコミットデータなどへのリンク」を、上記のように記載できます。
自分のリポジトリ情報に当てはめてみましょう。元のデータはこちらです。
これがこうなります。
意味を順に解説します。
通常のリストを表示させる記号「-」の後ろに[ ]または[x]を付与すると「タスクリスト(チェックボックス)」として表示されます。
[ ] はチェック無し、[x] はチェック付のボックスを表示します。
コメントの一文を選択した状態でキーボードの「r」キーを押すと、選択した本文がコメント欄に返信用として複写されます。特定のコメントに返信したい場合に便利です。
以下のように文章を選択して「r」キーを押すと……
選択した文書が「秒速」で引用されました。
他にも「#」でissueの番号呼び出し、「@」で特定ユーザーの名前参照など、知っておくと便利な機能があります。これを機に、一歩踏み込んだissue writingを試してみてはいかがでしょうか。
次回は、GitHubが提供するオンライン/オフラインのトレーニングプログラムを紹介します。
Nextremer 下岡聡子
Javaプログラマー、フリー翻訳者(英語・中国語)を経て、Nextremerにてインドでのグローバル受託開発システムのマネジメント、新規ビジネス企画担当。大学ではロシア語を専攻。
ITエンジニア向けの英語サービスも提供中。
Copyright © ITmedia, Inc. All Rights Reserved.