ディスカッションを使用してメンテナとコラボレーションする

GitHub Discussions を使用したメンテナとのコラボレーションについて

GitHub Discussions は、保守管理者が話し合うためのオープンフォーラムであり、GitHub Enterprise Server 上のリポジトリまたは組織のためのコミュニティです。プロジェクトを使用または貢献する場合は、ディスカッションを開始して提案を行い、計画、質問、アイデア、フィードバックについてメンテナやコミュニティメンバーと交流することができます。詳しくは、「ディスカッションについて」をご覧ください。

すべてのディスカッションは、カテゴリ内に作成しなければなりません。リポジトリディスカッションの場合、リポジトリの保守管理または管理のアクセス許可を持つユーザがそのリポジトリでディスカッションのカテゴリを定義します。 Organization ディスカッションの場合、ソースリポジトリの保守管理または管理のアクセス許可を持つユーザーがその Organization でディスカッションのカテゴリを定義します。それぞれのカテゴリには、オープンエンドのディスカッション、質問と回答、アナウンスといったフォーマットがあります。メンテナは、情報、リリース、イベントを共有するために、アナウンス形式のカテゴリを利用できます。これらのカテゴリ内のディスカッションが重要なアップデートに集中し続けるようにするために、新しいディスカッションを作成できるのはメンテナンスもしくは管理権限を持つ人だけになっていますが、コメントと返信は誰でもできます。

リポジトリ管理者とプロジェクトのメンテナは、そのリポジトリ内のディスカッションを削除できます。同様に、Organization のディスカッションのソースリポジトリの管理者とメンテナは、その Organization 内のディスカッションを削除できます。詳しくは、「ディスカッションを管理する」をご覧ください。

GitHubは、質問/回答のフォーマットのディスカッションに回答としてマークされた多くのコメントを寄せたコミュニティメンバーを自動的に認識します。これらのメンバーは、プロジェクトのディスカッションに最も役立つコントリビューターのリストに表示されます。

プロジェクトが成長するにつれて、コミュニティのアクティブなメンバーにより高いアクセス許可を付与できます。詳しくは、「上位コントリビューターにより高い権限を付与する」をご覧ください。

リポジトリの [ディスカッション] ページのスクリーンショット。 [Most helpful] (最も役に立つ) セクションが濃いオレンジ色の枠線で囲まれています。

コミュニティメンバーは、ディスカッションやディスカッション内の最上位のコメントに賛成投票して、重要なアイデアについてメンテナーと連絡することができます。その後、プロジェクトのメンテナーは、賛成票に基づいてディスカッションやコメントを並べ替えて、コミュニティのメンバーにとって価値のあることについての洞察を得ることができます。

ディスカッションへの参加の詳細については、「ディスカッションに参加する」を参照してください。

前提条件

リポジトリディスカッションでメンテナとコラボレーションするには、リポジトリ管理者またはプロジェクトのメンテナがリポジトリの GitHub Discussions を有効にする必要があります。詳しくは、「リポジトリの GitHub Discussions を有効化または無効化する」をご覧ください。

Organization のディスカッションでメンテナと共同作業するには、Organization に対して GitHub Discussions を有効にする必要があります。詳しくは、「組織の GitHub ディスカッションを有効または無効にする」をご覧ください。

ディスカッションを開始する

GitHub で、ディスカッションを始めるリポジトリまたは organization のメインページに移動します。
リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。
ページの右側にある [新しいディスカッション] をクリックします。
[Get started] (作業の開始) をクリックしてディスカッションのカテゴリを選びます。
[ディスカッションのタイトル] にディスカッションのタイトルを入力し、[Write] (書き込む) の下にディスカッションの本文を入力します。
[ディスカッションの開始] をクリックします。

ポーリングを開始する

GitHub で、リポジトリのメインページに移動します。
リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。
カテゴリの一覧で、 Polls をクリックします。
右側にある [新しいディスカッション] をクリックします。
[ディスカッションのタイトル] にタイトルを入力し、必要に応じて [Write] (書き込む) に投票の本文を入力します。
[Poll question] (投票の質問) に投票の質問を入力します。
[Poll options] (投票の選択肢) には、投票の選択肢を 2 つ以上入力します。
必要に応じてさらに投票オプションを追加するには、 [オプションの追加] をクリックします。
Start poll をクリックします。

ディスカッションのリストをフィルタする

ディスカッションを検索し、リポジトリまたは Organization 内のディスカッションのリストをフィルタできます。詳しくは、「ディスカッションを検索する」をご覧ください。

GitHub で、リポジトリまたは organization のメインページに移動します。
リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。
[すべてのディスカッションを検索] フィールドに、検索クエリを入力します。必要に応じて、検索フィールドの右側にあるボタンをクリックして、結果をさらにフィルタします。
ディスカッションのリストで、表示するディスカッションをクリックします。

ディスカッションの一覧をフィルター処理する

ディスカッションの一覧を並べ替える方法を選択できます。

GitHub で、リポジトリまたは organization のメインページに移動します。
リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。
[Search all discussions] (すべてのディスカッションの検索) フィールドの右にある [並べ替え] ドロップダウンメニューを選び、期間をクリックします。
- 最新のアクティビティを含むディスカッションを一覧の先頭に表示するには、 [最新のアクティビティ] で並べ替えます。
- 最近作成されたディスカッションを一覧の先頭に表示するには、 [作成日] で並べ替えます。
- 最も賛成票の多いディスカッションを一覧の先頭に表示するには、 [上位] で並べ替えます。特定の期間のディスカッションのみを表示するように一覧を制限できます。

ディスカッションの最上位のコメントを並べ替える

ディスカッションの最上位のコメントを並べ替える方法を選べます。コメントスレッドは、コメントの並べ替え順序に影響しません。

GitHub で、リポジトリまたは organization のメインページに移動します。
リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。
ディスカッションのリストで、表示するディスカッションをクリックします。
メインのディスカッション投稿で、 [古い順] 、 [新しい順] 、または [上位] を選びます。
- 最も古い最上位コメントを最初に表示するには、 [古い順] で並べ替えます。
- 最も新しい最上位コメントを最初に表示するには、 [新しい順] で並べ替えます。
- 最も賛成票の多い最上位コメントを最初に表示するには、 [上位] で並べ替えます。

Issue をディスカッションに変換する

Issueが追跡して優先順位付けするような作業アイテムというよりは、疑問や自由形式の会話であることが分かった場合には、Issueをディスカッションに変換できます。詳細については、「ディスカッションをモデレートする」を参照してください。

参考資料

「GitHub 上での執筆とフォーマットについて」