Skip to main content

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

ディスカッションでプロジェクトのメンテナと連絡を取り合うことにより、GitHub でプロジェクトの目標、計画、健全性、およびコミュニティに貢献できます。

この機能を使用できるユーザーについて

People with read access to a repository can start and participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can start and participate in discussions and polls in the organization.

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

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

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

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

GitHubは、質問/回答のフォーマットのディスカッションに回答としてマークされた多くのコメントを寄せたコミュニティメンバーを自動的に認識します。 これらのメンバーは、そのプライバシーの設定で許可されている場合、プロジェクトのディスカッションに最も役立つコントリビューターのリストに表示されます。 詳細については、「プロファイルをプライベートに設定する」を参照してください。

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

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

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

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

前提条件

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

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

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

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

  2. リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。

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

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

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

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

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

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

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

ポーリングを開始する

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

  2. リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。

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

  3. [すべてのディスカッションを検索] フィールドに、検索クエリを入力します。 必要に応じて、検索フィールドの右側にあるボタンをクリックして、結果をさらにフィルタします。

    ディスカッションをフィルター処理するため検索バーとボタンのスクリーンショット。

  4. ディスカッションのリストで、表示するディスカッションをクリックします。

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

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

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

  2. リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。

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

  3. [Search all discussions] (すべてのディスカッションの検索) フィールドの右にある [並べ替え] ドロップダウン メニューを選び、期間をクリックします。

    ディスカッションを並べ替えるボタンが並んでいるスクリーンショット。 "並べ替え: 最新のアクティビティ" というラベルの付いたボタンが、オレンジ色の枠線で強調表示されています。

    • 最新のアクティビティを含むディスカッションを一覧の先頭に表示するには、 [最新のアクティビティ] で並べ替えます。
    • 最近作成されたディスカッションを一覧の先頭に表示するには、 [作成日] で並べ替えます。
    • 最も賛成票の多いディスカッションを一覧の先頭に表示するには、 [上位] で並べ替えます。 特定の期間のディスカッションのみを表示するように一覧を制限できます。

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

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

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

  2. リポジトリ名または Organization 名の下にある [ディスカッション] をクリックします。

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

  3. ディスカッションのリストで、表示するディスカッションをクリックします。

  4. メインのディスカッション投稿で、 [古い順][新しい順] 、または [上位] を選びます。

    ディスカッションのスクリーンショット。 ディスカッションのコメントを並べ替えるボタンが濃いオレンジ色の枠線で囲まれています。

    • 最も古い最上位コメントを最初に表示するには、 [古い順] で並べ替えます。
    • 最も新しい最上位コメントを最初に表示するには、 [新しい順] で並べ替えます。
    • 最も賛成票の多い最上位コメントを最初に表示するには、 [上位] で並べ替えます。

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

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

参考資料