ディスカッションについて

GitHub Discussions について

GitHub Discussions を使用すると、プロジェクトのコミュニティは、プロジェクトのリポジトリまたは Organization 内で会話を作成して参加できます。 ディスカッションにより、プロジェクトのメンテナ、コントリビューター、訪問者は、サードパーティのツールを使用せずに、一か所に集合し、次のような目標を集めて達成できます。

• お知らせや情報を共有し、フィードバックを収集し、計画を立案して、意思決定を行う
• 質問し、質問についてディスカッションを行い、回答し、ディスカッションに回答済みのマークを付ける
• 投票を作成してコミュニティの意見を評価する
• 貴重なアイデアの可視性を高めるために、ディスカッションやコメントをプラス投票する
• 訪問者とコントリビューターが目標、開発、管理、ワークフローについて話し合うための居心地の良い雰囲気を育む

リポジトリのディスカッションを使用して、リポジトリに固有のトピックについて説明できます。 プロジェクトが複数のリポジトリにまたがる場合は、Organization のディスカッションを使用して、Organization 内の 1 つのリポジトリに固有ではないトピックについて話し合うことができます。

ディスカッションが解決された場合、関連性がなくなった場合、または重複している場合は、ディスカッションをクローズすることができます。 詳しくは、「ディスカッションをクローズする」をご覧ください。

リポジトリ管理者またはプロジェクトの保守担当者がリポジトリの GitHub Discussions を有効にすると、リポジトリにアクセスできるすべての人がそのリポジトリのディスカッションを作成して参加できます。 Organization の所有者が Organization に対して GitHub Discussions を有効にすると、ソース リポジトリを表示できるすべてのユーザーが Organization のディスカッションを作成できます。

リポジトリ管理者とプロジェクトメンテナは、リポジトリ内のディスカッションとディスカッションカテゴリを管理し、ディスカッションを固定してディスカッションの可視性を高めることができます。 モデレータとコラボレータは、コメントを回答としてマークしたり、ディスカッションをロックしたり、Issue をディスカッションに変換したりすることができます。 同様に、Organization のディスカッションでは、ソース リポジトリ内のユーザーのロールによって、ユーザーが Organization のディスカッションとやり取りする方法が決まります。 詳しくは、「Organizationのリポジトリロール」を参照してください。

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

投票について

投票カテゴリに投票を作成して、新しいアイデアやプロジェクトの方向性への関心を評価できます。 リポジトリへの読み取りアクセス権を持つすべてのユーザーは、投票を作成し、投票を行い、結果を表示できます。

投票には質問と少なくとも 2 つの選択肢が必要です。 選択肢は最大 8 つまで追加でき、最大 128 文字を含めることができます。

投票者は投票を変更できません。 投票を編集すると、既にキャストされている投票がリセットされます。

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

ディスカッションの整理について

カテゴリおよびラベルを使って、ディスカッションを整理できます。

コミュニティのメンバーが適切な場所で会話を始められるように、そしてコミュニティのメンバーが関連するディスカッションを見つけやすくなるように、ディスカッションをカテゴリ付けできます。 すべてのディスカッションは、カテゴリ内に作成しなければなりません。 リポジトリディスカッションの場合、リポジトリの保守管理または管理のアクセス許可を持つユーザがそのリポジトリでディスカッションのカテゴリを定義します。 Organization ディスカッションの場合、ソース リポジトリの保守管理または管理のアクセス許可を持つユーザーがその Organization でディスカッションのカテゴリを定義します。 それぞれのカテゴリには、オープンエンドのディスカッション、質問と回答、アナウンスといったフォーマットがあります。 各リポジトリまたは組織は、最大で 25 個のカテゴリを持つことができます。

質問/回答形式のディスカッションの場合、ディスカッション内の個々のコメントをディスカッションの回答としてマークできます。 GitHubは、質問/回答のフォーマットのディスカッションに回答としてマークされた多くのコメントを寄せたコミュニティメンバーを自動的に認識します。

メンテナは、情報、リリース、イベントを共有するために、アナウンス形式のカテゴリを利用できます。 これらのカテゴリ内のディスカッションが重要なアップデートに集中し続けるようにするために、新しいディスカッションを作成できるのはメンテナンスもしくは管理権限を持つ人だけになっていますが、コメントと返信は誰でもできます。

詳しくは、「ディスカッションのカテゴリを管理する」を参照してください。

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

Best practices for GitHub Discussions

コミュニティのメンバーまたはメンテナとして、コミュニティに影響を与える質問をしたり、情報について話し合ったりするためのディスカッションを開始します。 詳しくは、「ディスカッションを使用してメンテナとコラボレーションする」を参照してください。

ディスカッションに参加して、質問をしたり、回答したり、フィードバックを提供したり、プロジェクトのコミュニティに参加したりすることができます。 詳しくは、「ディスカッションに参加する」を参照してください。

コミュニティのメンバー間の重要、有用、または模範的な会話を含むディスカッションにスポットライトを当てることができます。 詳しくは、「ディスカッションを管理する」を参照してください。

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

フィードバックを送る

GitHub Discussions に関するフィードバックを GitHub と共有できます。 会話に参加するには、GitHub Community のディスカッションを参照してください。

参考資料

• GitHub 上での執筆とフォーマットについて
• ディスカッションを検索する
• 通知について
• コメントおよび会話をモデレートする