GitHub Discussions のクイックスタート

既存のリポジトリまたは Organization で GitHub Discussions を有効にして、コミュニティとの会話を開始します。

この記事で

はじめに

GitHub Discussions は、オープン ソースまたは内部プロジェクトに関するコミュニティ向けの共同コミュニケーション フォーラムです。 Discussions は、GitHub Issues とは異なり、透過的でアクセス可能である必要がありますが、プロジェクトで追跡する必要がなく、コードに関連しない会話を対象としています。 Discussions により、公開フォーラムで流動的でオープンな会話ができるようになります。

Discussions では、共同作業的な会話ができるように、情報を結びつけ、見つけるための一箇所にまとめられた空間を提供しています。

リポジトリの GitHub Discussions を有効化する

リポジトリの所有者と書き込みアクセス権を持つユーザーは、パブリックおよび非公開のリポジトリのコミュニティで GitHub Discussions を有効にできます。 ディスカッションの可視性は、ディスカッションが作成されたリポジトリから継承されます。

GitHub Discussions を初めて有効化すると、ウェルカム投稿を設定するように求められます。

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. リポジトリ名の下にある 設定 をクリックします。

    GitHub リポジトリのタブのスクリーンショット。 [設定] オプションが濃いオレンジ色の枠線で囲まれています。

  3. [機能] セクションまでスクロールし、 [Set up discussions] (ディスカッションの設定) をクリックします。

    リポジトリの設定の [ディスカッション] オプションのスクリーンショット。 [Set up discussions] (ディスカッションの設定) という緑色のボタンが濃いオレンジ色の枠線で囲まれています。

  4. [Start a new discussion] で、コミュニティに設定したいリソースとトーンに合わせてテンプレートを編集します。

  5. [ディスカッションの開始] をクリックします。

組織の GitHub Discussions を有効化する

組織の所有者は、組織の GitHub Discussions を有効にすることができます。

Organization のディスカッションを有効にするときに、Organization のディスカッションの��ース リポジトリとして Organization 内のリポジトリを選択します。 既存のリポジトリを使用することも、Organization のディスカッションを保持するための専用のリポジトリを作成することもできます。 ディスカッションは、Organization のディスカッション ページとソース リポジトリのディスカッション ページの両方に表示されます。

Organization 内のディスカッションに参加またはそれを管理するためのアクセス許可は、ソース リポジトリのアクセス許可に基づきます。 たとえば、ユーザーが Organization のディスカッションを削除するには、ソース リポジトリへの書き込みアクセス許可が必要になります。 これは、ユーザーがリポジトリ ディスカッションを削除するには、リポジトリでの書き込みアクセス許可が必要になる場合と同じです。

ソース リポジトリはいつでも変更できます。 ソース リポジトリを変更しても、ディスカッションは新しいソース リポジトリに転送されません。

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

  2. Organization 名の下で、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  3. [ディスカッション] で、 [この Organization のディスカッションを有効にする] を選択します。

  4. ドロップダウン メニューを使って、組織のディスカッションのソース リポジトリとして使うリポジトリを選びます。

  5. [保存] をクリックします。

ディスカッションへのコントリビューションを歓迎する

ウェルカム投稿を作成して、その投稿を GitHub Discussions ページにピン留めすることで、コミュニティを歓迎し、リポジトリまたは組織で通信するための新しい方法を紹介できます。 ディスカッションをピン留めしてロックすると、投稿がお知らせであることを周知するのに役立ちます。 お知らせを使用すると、ユーザをより多くのリソースにリンクし、コミュニティでディスカッションをオープンするためのガイダンスを提供できます。 ディスカッションのピン留めについて詳しくは、「ディスカッションを管理する」を参照してください。

コントリビューター向けのコミュニティガイドラインを設定する

リポジトリのディスカッションでは、コントリビューションガイドラインを設定して、コラボレータがリポジトリについて有意義で有用な会話を行うよう促すことができます。 リポジトリの README を更新して、コラボレータが Issue やディスカッションをオープンするタイミングを伝えることもできます。 プロジェクトのガイドラインを提供する方法の詳細については、「プロジェクトへの行動規範の追加」と「健全なコントリビューションを促すプロジェクトをセットアップする」を参照してください。

組織のディスカッションでは、組織のプロフィールの README を作成することで、組織との関わり方に関する情報を共有できます。 詳しくは、「Organizationのプロフィールのカスタマイズ」をご覧ください。

新しいディスカッションを作成する

リポジトリを表示できる認証されたユーザーが、そのリポジトリでディスカッションを作成できます。 同様に、組織のディスカッションはソース リポジトリに基づいているため、ソース リポジトリを表示できる認証されたユーザーは、その組織でディスカッションを作成できます。

  1. GitHub で、ディスカッションを始めるリポジトリまたは organization のメイン ページに移動します。

  2. リポジトリ名または organization 名の下にある [Discussions] をクリックします。

    GitHub リポジトリのタブのスクリーンショット。 [ディスカッション] が濃いオレンジ色の枠線で囲まれています。

  3. ページの右側にある [新しいディスカッション] をクリックします。

  4. [Get started] (作業の開始) をクリックしてディスカッションのカテゴリを選びます。

    [Select a discussion category] (ディスカッションのカテゴリを選択してください) ページのスクリーンショット。 [Get started] (作業の開始) というボタンが濃いオレンジ色の枠線で囲まれています。

  5. [ディスカッションのタイトル] にディスカッションのタイトルを入力し、[Write] (書き込む) の下にディスカッションの本文を入力します。

    新しいディスカッションのタイトルと本文のテキスト フィールドのスクリーンショット。

  6. [ディスカッションの開始] をクリックします。

新しい投票を作成

リポジトリを表示できる認証されたユーザーが、ポーリングを作成できます。 同様に、組織のディスカッションはソース リポジトリに基づいているため、ソース リポジトリを表示できる認証されたユーザーは、その組織でポーリングを作成できます。

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. リポジトリ名または organization 名の下にある [Discussions] をクリックします。

    GitHub リポジトリのタブのスクリーンショット。 [ディスカッション] が濃いオレンジ色の枠線で囲まれています。

  3. カテゴリの一覧で、 Polls をクリックします。

    [ディスカッション] タブの [カテゴリ] セクションのスクリーンショット。[投票] カテゴリが濃いオレンジ色の枠線で囲まれています。

  4. 右側にある [新しいディスカッション] をクリックします。

  5. [ディスカッションのタイトル] にタイトルを入力し、必要に応じて [Write] (書き込む) に投票の本文を入力します。

    新しい投票を開始するページのスクリーンショット。

  6. [Poll question] (投票の質問) に投票の質問を入力します。

  7. [Poll options] (投票の選択肢) には、投票の選択肢を 2 つ以上入力します。

  8. 必要に応じてさらに投票オプションを追加するには、 [Add an option] をクリックします。

    新しい投票を開始するページのスクリーンショット。 プラス アイコンと [Add an option] (選択肢の追加) が濃いオレンジ色の枠線で囲まれています。

  9. Start poll をクリックします。

ディスカッションを整理する

リポジトリの所有者とリポジトリへの書き込みアクセス権を持つユーザーは、ディスカッションを整理するための新しいカテゴリを作成できます。 同様に、組織のディスカッションはソース リポジトリに基づいているため、リポジトリの所有者とソース リポジトリへの書き込みアクセス権を持つユーザーは、組織のディスカッション用の新しいカテゴリを作成できます。

参加しているコラボレータが新しいディスカッションを作成する場合、ディスカッションを最も関連性の高い既存のカテゴリにグループ化できます。 ディスカッションは、作成後に再分類することもできます。 詳しくは、「ディスカッションのカテゴリを管理する」をご覧ください。

ディスカッションをより詳細に整理するために、ラベルを適用できます。 たとえば、ラベルを使ってディスカッションのステータスを示し、効率的にトリアージできるようにすることができます。 各リポジトリには、Issue、Pull Reqeust、ディスカッションのための共有ラベルセットが1つあります。 詳しくは、「ラベルを管理する」をご覧ください。

健全な会話を促進する

リポジトリへの書き込み権限を持つユーザー、または組織のディスカッションのためのソース リポジトリの書き込み権限を持つユーザーは、ディスカッションをピン留めし、役に立たなくなった、またはコミュニティに害を与えているディスカッションを削除し、組織が所有するより関連性の高いリポジトリにディスカッションを移譲することで、重要な会話を明示できます。 詳しくは、「ディスカッションを管理する」をご覧ください。

リポジトリのトリアージ権限を持つユーザー、または組織のディスカッションのためのソース リポジトリのトリアージ権限を持つユーザーは、コメントを回答としてマークし、役に立たなくなった、またはコミュニティに損害を与えているディスカッションをロックし、アイデアがまだ開発の初期段階にあるときに Issue をディスカッションに変換することで、プロジェクトのディスカッションをモデレートするのに役立ちます。 詳しくは、「ディスカッションをモデレートする」をご覧ください。

次のステップ

作業を確認してアイデアをコンセプト��ら現実に移すための明確な道筋ができたら、Issue を作成して進捗状況の追跡を開始できます。 ディスカッションから issue を作成する方法の詳細については、「ディスカッションをモデレートする」を参照してください。