Skip to main content

Managing categories for discussions

You can categorize discussions to organize conversations for your community members, and you can choose a format for each category.

Who can use this feature

Repository administrators and people with write or greater access to a repository can manage categories for discussions in the repository. Repository administrators and people with write or greater access to the source repository for organization discussions can manage categories for discussions in the organization.

About categories for discussions

GitHub Discussions 是在 GitHub 上供存储库或组织的维护者和社区之间进行对话的开放论坛。 所有讨论都必须在类别中创建。 对于存储库讨论,由对存储库具有维护权限或管理员权限的人员定义该存储库中讨论的类别。 对于组织讨论,由对源存储库具有维护权限或管理员权限的人员定义该组织中讨论的类别。 每个类别都有一个格式:开放式讨论、问答或公告。

维护者可以使用通知格式的类别来分享信息、发布或事件。 为了使这些类别的讨论集中于重要的更新,只有拥有维护或管理权限的人才可创建新的讨论,但任何人都可以评论和回复。

Each category must have a unique name and emoji pairing, and can be accompanied by a detailed description stating its purpose. Categories help maintainers organize how conversations are filed and are customizable to help distinguish categories that are Q&A or more open-ended conversations. 每个存储库或组织最多可以有 25 个类别。 For more information, see "About discussions."

Default categories

CategoryPurposeFormat
📣 AnnouncementsUpdates and news from project maintainersAnnouncement
#️⃣ GeneralAnything and everything relevant to the projectOpen-ended discussion
💡 IdeasIdeas to change or improve the projectOpen-ended discussion
🗳 PollsPolls with multiple options for the community to vote for and discussPolls
🙏 Q&AQuestions for the community to answer, with a question/answer formatQuestion and Answer
🙌 Show and tellCreations, experiments, or tests relevant to the projectOpen-ended discussion

Creating a category

  1. On GitHub.com, navigate to the main page of the repository or organization where you want to create a category.
  2. 在存储库或组织名称下,单击 “讨论”。 存储库的“讨论”选项卡
  3. 在“Categories(类别)”右侧,单击 用于编辑类别的铅笔图标
  4. Click New category. "New category" button above list of discussion categories for a repository
  5. Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "About discussions." Emoji, title, description, and discussion format for new category
  6. Click Create. "Create" button for new category

Editing a category

You can edit a category to change the category's emoji, title, description, and discussion format.

  1. On GitHub.com, navigate to the main page of the repository or organization where you want to edit a category.
  2. 在存储库或组织名称下,单击 “讨论”。 存储库的“讨论”选项卡
  3. To the right of a category in the list, click . Edit button to the right of category in list of categories for a repository
  4. 编辑类别的表情符号、标题、说明和讨论格式。 有关讨论格式的详细信息,请参阅“关于讨论”。 Editing emoji, title, description, and discussion format for existing category
  5. Click Save changes. "Save changes" button for existing category

Deleting a category

When you delete a category, GitHub will move all discussions in the deleted category to an existing category that you choose.

  1. On GitHub.com, navigate to the main page of the repository or organization where you want to delete a category.
  2. 在存储库或组织名称下,单击 “讨论”。 存储库的“讨论”选项卡
  3. To the right of a category in the list, click . Trash button to the right of category in list of categories for a repository
  4. Use the drop-down menu, and choose a new category for any discussions in the category you're deleting. Drop-down menu for choosing new category when deleting an existing category
  5. Click Delete & Move. Drop-down menu for choosing new category when deleting an existing category