Collaborating with maintainers using discussions

About collaboration with maintainers using GitHub Discussions

GitHub Discussions は、保守管理者が話し合うためのオープン フォーラムであり、GitHub Enterprise Cloud 上のリポジトリまたは組織のためのコミュニティです。 If you use or contribute to a project, you can start a discussion to make suggestions and engage with maintainers and community members about your plans, questions, ideas, and feedback. For more information, see "About discussions."

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

Repository administrators and project maintainers can delete a discussion in that repository. Similarly, administrators and maintainers of the source repository for an organization's discussions can delete a discussion in that organization. For more information, see "Managing discussions."

GitHubは、質問/回答のフォーマットのディスカッションに回答としてマークされた多くのコメントを寄せたコミュニティメンバーを自動的に認識します。 These members appear in a list of the most helpful contributors to the project's discussions. As your project grows, you can grant higher access permissions to active members of your community. For more information, see "Granting higher permissions to top contributors"

Community members can upvote discussions and top-level comments inside discussions to communicate with maintainers about ideas that matter to them. Project maintainers can then sort discussions and comments based on upvotes to gain insight into what community members value.

For more information about participation in discussions, see "Participating in a discussion."

Prerequisites

To collaborate with maintainers in repository discussions, a repository administrator or project maintainer must enable GitHub Discussions for the repository. For more information, see "Enabling or disabling GitHub Discussions for a repository."

To collaborate with maintainers in organization discussions, GitHub Discussions must be enabled for the organization. For more information, see "Enabling or disabling GitHub Discussions for an organization."

Starting a discussion

1. On GitHub.com, navigate to the main page of the repository or organization where you want to start a discussion.
2. リポジトリ名または組織名の下にある [ディスカッション] をクリックします。
3. Click New discussion.
4. Select the Select Category drop-down menu, and click a category for your discussion.
5. Type a title and body for your discussion.
6. Click Start discussion.

Starting a poll

1. On GitHub.com, navigate to the main page of the repository. 1. リポジトリ名または組織名の下にある [ディスカッション] をクリックします。
2. カテゴリの一覧で、 [Polls](投票) をクリックします。
3. 右側の [Start poll](投票の開始) をクリックします。
4. 投票のタイトルと本文 (省略可能) を入力します。
5. 投票の質問を入力します。
6. 投票のオプションを少なくとも 2 つ入力します。
7. 必要に応じて別の投票オプションを追加するには、 [オプションの追加] をクリックします。
8. [Start poll](投票の開始) をクリックします。

Filtering the list of discussions

You can search for discussions and filter the list of discussions in a repository or organization. For more information, see "Searching discussions."

1. On GitHub.com, navigate to the main page of the repository or organization.
2. リポジトリ名または組織名の下にある [ディスカッション] をクリックします。
3. In the Search all discussions field, type a search query. Optionally, to the right of the search field, click a button to further filter the results.
4. In the list of discussions, click the discussion you want to view.

Sorting the list of discussions

You can choose how to sort the list of discussions.

1. On GitHub.com, navigate to the main page of the repository or organization.

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

3. To the right of the Search all discussions field, select New, or select Top and choose a time period from the drop down menu.

   

   • Sort by New to display the discussions with the most recent activity at the top of the list.
   • Sort by Top to display the discussions with the most upvotes at the top of the list. You can limit the list to only display discussions from a specific time period.

Sorting top-level comments in discussions

You can choose how to sort top-level comments in discussions. Comment threads do not impact the order comments are sorted in.

1. On GitHub.com, navigate to the main page of the repository or organization.

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

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

4. Under the main discussion post, select Oldest, Newest, or Top.

   

   • Sort by Oldest to display the oldest top-level comments first.
   • Sort by Newest to display the newest top-level comments first.
   • Sort by Top to display the most upvoted top-level comments first.

Converting an issue to a discussion

Issueが追跡して優先順位付けするような作業アイテムというよりは、疑問や自由形式の会話であることが分かった場合には、Issueをディスカッションに変換できます。 For more information, see "Moderating discussions."

Further reading

• "About writing and formatting on GitHub"
• "Maintaining your safety on GitHub"