Skip to main content

プロジェクト(ベータ)のクイックスタート

このインタラクティブガイドでプロジェクトを作成して、プロジェクト(ベータ)のスピード、柔軟性、カスタマイズを体験してください。

Note: Projects (beta) is currently in public beta and subject to change.

はじめに

このガイドは、プロジェクト(ベータ)を使って作業を計画し、追跡する方法を紹介します。 このガイドでは、新しいプロジェクトを作成し、タスクの優先度を追跡するためにカスタムフィールドを追加します。 また、コラボレータと優先度や進捗について伝えるための役に立つ、保存されるビューも作成します。

必要な環境

Organizationプロジェクトもしくはユーザプロジェクトを作成できます。 Organizationプロジェクトを作成するには、GitHub Organizationが必要です。 Organizationの作成に関する詳しい情報については「新しいOrganizationを最初から作成する 」を参照してください。

このガイドでは、新しいプロジェクトに対して自分のOrganizationが所有するリポジトリから既存のIssueを追加する(Organizationプロジェクトの場合)か、自分が所有するリポジトリから追加(ユーザプロジェクトの場合)します。 Issueの作成に関する詳しい情報については「Issueの作成」を参照してください。

プロジェクトの作成

まず、Organizationプロジェクトもしくはユーザプロジェクトを作成してください。

Organizationプロジェクトの作成

  1. GitHubで、Organizationのメインページにアクセスしてください。

  2. Projects(プロジェクト)をクリックしてください。

  3. New project(新規プロジェクト)ドロップダウンメニューを選択して、New project (Beta)(新規プロジェクト ベータ)をクリックしてください。

    新規プロジェクト

  4. When prompted to select a template, click a template or, to start with an empty project, click "Table" or "Board". Then, click Create.

    Screenshot showing template selection modal

ユーザプロジェクトの作成

  1. On any GitHub Enterprise Cloud page, click on your avatar, then select Your projects.

  2. New project(新規プロジェクト)ドロップダウンメニューを選択して、New project (Beta)(新規プロジェクト ベータ)をクリックしてください。

    新規プロジェクト

  3. When prompted to select a template, click a template or, to start with an empty project, click "Table" or "Board". Then, click Create.

    Screenshot showing template selection modal

プロジェクトの説明とREADMEの設定

You can set your project's description and README to share the purpose of your project, provide instructions on how to use the project, and include any relevant links.

  1. プロジェクトにアクセスします。
  2. In the top-right, click to open the menu.
  3. In the menu, click Settings to access the project settings.
  4. To add a short description to your project, under "Add a description", type your description in the text box and click Save.
  5. To update your project's README, under "README", type your content in the text box.
  6. To save changes to your README, click Save.

You can view and make quick changes to your project description and README by navigating to your project and clicking in the top right.

プロジェクトへのIssueの追加

次に、いくつかのIssueをプロジェクトに追加してください。

新しいプロジェクトが初期化されると、プロジェクトにアイテムを追加するよう求められます。 このビューを逃したり、Issueは後で追加したい場合には、カーソルをプロジェクトの下部の行のの隣に持ってきてください。

  1. #と入力してください。
  2. Issueがあるリポジトリを選択してください。 リポジトリ名の一部を入力すれば、選択肢を狭めることができます。
  3. Issueを選択してください。 Issueのタイトルの一部を入力していって、選択肢を狭めることができます。

上記のステップを何回か繰り返し、複数のIssueをプロジェクトに追加してください。

プロジェクトにIssueを追加する他の方法、あるいはプロジェクトに追加できる他のアイテムに関する情報については、「プロジェクトの作成」を参照してください。

プロジェクトへのドラフトIssueの追加

次に、プロジェクトにドラフトIssueを追加してください。

  1. カーソルをプロジェクトの最下行、の隣に持ってきてください。
  2. アイデアを入力し、Enterを押してください。
  3. ドラフトIssueのタイトルをクリックしてください。 表示されるMarkdownの入力ボックスに、アイデアに関する情報をもう少し入力し、Save(保存)をクリックしてください。

優先度を追跡するためのフィールドの作成

次に、HighMediumLowのいずれかの値を含むPriorityというカスタムフィールドを作成してください。

  1. To open the project command palette, press Command+K (Mac) or Ctrl+K (Windows/Linux).
  2. "Create new field"のどこかを入力し始めてください。
  3. Create new fieldを選択してください。
  4. 表示されるポップアップで、テキストボックスにPriorityと入力してください。
  5. ドロップダウンでSingle select(単一選択)を選択してください。
  6. HighMediumLowという選択肢を追加してください。 選択肢には絵文字を含めることもできます。 新しい単一選択フィールドの例
  7. [Save] をクリックします。

プロジェクト中のすべてのIssueに優先度を指定してください。

優先度の例

優先度によるIssueのグループ化

次に、高優先度のアイテムに集中しやすくするために、プロジェクト中のすべてのアイテムを優先度でグループ化します。

  1. To open the project command palette, press Command+K (Mac) or Ctrl+K (Windows/Linux).
  2. "Group by"のどこかを入力し始めてください。
  3. Group by: Priorityを選択してください。

さあ、優先度を変更するために、Issueをグループ間で移動させてください。

  1. Issueを選択してください。
  2. Issueを様々な優先度のグループにドラッグアンドドロップしてください。 こうすると、Issueの優先度は新しいグループの優先度に変更されます。

グループ間でのIssueの移動

優先度ビューの保存

前のステップにおいて優先度でIssueをグループ化すると、プロジェクトはビューが変更されたことを示すインジケーターを表示します。 コラボレータも優先度でグループ化されたタスクを見ることができるように、これらの変更を保存してください。

  1. ビュー名の隣のドロップダウンメニューを選択してください。
  2. [Save changes] をクリックします。

ビューの目的を示すために、分かりやすい名前を付けてください。

  1. 現在のビュー名のView 1にカーソルを置いてください。
  2. 既存のテキストを、新しい名前のPrioritiesで置き換えてください。

全員がプロジェクトの優先度に合わせていられるよう、TeamとこのURLを共有できます。

ビューが保存されると、プロジェクトをオープンした人は誰でもこの保存されたビューを見ることができます。 ここでは優先度でグループ化していますが、ソート、フィルタ、レイアウトなどの他の修飾子を追加することもできます。 次に、レイアウトを変更した新しいビューを作成しましょう。

ボードレイアウトの追加

プロジェクトのIssueの進捗状況を見るには、ボードレイアウトに切り替えることができます。

ボードレイアウトはstatusフィールドに基づくので、プロジェクト中の各Issueのステータスを指定してください。

ステータスの例

続いて、新しいビューを作成してください。

  1. 右端のビューの隣にある New view(新しいビュー)をクリックしてください。

次に、ボードレイアウトに切り替えてください。

  1. To open the project command palette, press Command+K (Mac) or Ctrl+K (Windows/Linux).
  2. "Switch layout: Board"のどこかを入力し始めてください。
  3. Switch layout: Boardを選択してください。 優先度の例

レイアウトを変更すると、プロジェクトはそのビューが変更されたことを示すインジケーターを表示します。 このビューを保存して、あなたやコラボレータが将来簡単にアクセスできるようにしてください。

  1. ビュー名の隣のドロップダウンメニューを選択してください。
  2. [Save changes] をクリックします。

ビューの目的を示すために、分かりやすい名前を付けてください。

  1. 現在のビュー名のView 2にカーソルを置いてください。
  2. 既存のテキストを、新しい名前のProgressで置き換えてください。

優先度の例

組み込みの自動化の設定

最後に、組み込みのワークフローを追加して、アイテムがプロジェクトに追加されたときにステータスがTodoに設定されるようにしてください。

  1. プロジェクトでをクリックしてください。
  2. Default workflows(デフォルトのワークフロー)の下で、Item added to project(アイテムがプロジェクトに追加)をクリックしてください。
  3. When(時期)の隣で、issuespull requestsがどちらも選択されていることを確認してください。
  4. Set(設定)の隣で、Status:Todoを選択してください。
  5. Disabled(無効)トグルをクリックして、ワークフローを有効化してください。

次のステップ

プロジェクトは、幅広い目的で利用できます。 例:

  • リリースの作業の追跡
  • スプリントの計画
  • バックログの優先順位付け

GitHubのIssue で次のステップに進む際に役立つ、以下のようなリソースを参照してください。