简介
GitHub Discussions 是一个围绕开源项目为社区提供协作沟通的论坛。 不像 GitHub Issues，讨论用于需要透明和可访问的对话，但不需要在项目板上进行跟踪，并且与代码无关。 讨论使公共论坛中能够进行流畅、公开的对话。
通过连接和提供更集中的区域来连接和查找信息，讨论为更多协作对话提供了空间。
在仓库中启用 GitHub Discussions
仓库所有者和具有写入访问权限的人可在其公共和私有仓库中为社区启用 GitHub Discussions。
当您首次启用 GitHub Discussions 时，将邀请您配置欢迎帖子。
- 在 GitHub.com 上，导航到仓库的主页面。
- 在仓库名称下，单击 Settings（设置）。
- 在“Features（功能）”下，单击 Set up discussions（设置讨论）。
- 在“Start a new discussion（开始新讨论）”下，编辑模板以与要为社区设置的资源和语气保持一致。
- 单击 Start discussion（开始讨论）。
Enabling GitHub Discussions on your organization
Organization owners can enable GitHub Discussions for their organization.
When you enable organization discussions, you will choose a repository in the organization to be the source repository for your organization discussions. You can use an existing repository or create a repository specifically to hold your organization discussions. Discussions will appear both on the discussions page for the organization and on the discussion page for the source repository.
Permission to participate in or manage discussion in your organization is based on permission in the source repository. For example, a user needs write permission to the source repository in order to delete an organization discussion. This is identical to how a user needs write permission in a repository in order to delete a repository discussion.
You can change the source repository at any time. If you change the source repository, discussions are not transferred to the new source repository.
- 在 GitHub.com 上，导航到组织的主页面。
- Under your organization name, click Settings.
- Under "Discussions", select Enable discussions for this organization.
- Select a repository to use as the source repository for your organization discussions.
- 单击 Save（保存）。
欢迎参与您的讨论
You can welcome your community and introduce a new way to communicate in a repository or organization by creating a welcome post and pinning the post to your GitHub Discussions page. 固定和锁定讨论有助于人们知道帖子是作为公告发布的。 您可以使用公告将人员链接到更多资源，并指导在社区中开始讨论。 For more information about pinning a discussion, see "Managing discussions."
为贡献者设置社区指南
For repository discussions, you can set contributing guidelines to encourage collaborators to have meaningful, useful conversations that are relevant to the repository. 您还可以更新仓库的 README，以传达协作者何时应打开问题或讨论的期望。 有关为项目提供指南的更多信息，请参阅“为项目添加行为准则”和“设置健康参与的项目”。
For organization discussions, you share information about how to engage with your organization by creating an organization profile README. 更多信息请参阅“自定义组织的配置文件”。
创建新讨论
Any authenticated user who can view the repository can create a discussion in that repository. Similarly, since organization discussions are based on a source repository, any authenticated user who can view the source repository can create a discussion in that organization.
- 在 GitHub.com, navigate to the main page of the repository or organization where you want to start a discussion.
- Under your repository or organization name, click Discussions.
- 单击 New discussion（新讨论）。
- 选择 Select Category（选择类别）下拉菜单，然后单击讨论的类别。
- 输入讨论的标题和正文。
- 单击 Start discussion（开始讨论）。
Creating a new poll
Any authenticated user who can view a repository can create a poll. Similarly, since organization discussions are based on a source repository, any authenticated user who can view the source repository can create a poll in that organization.
- 在 GitHub.com 上，导航到仓库的主页面。
- Under your repository or organization name, click Discussions.
- In the list of categories, click Polls.
- On the right, click Start poll.
- Type a title and optional body for your poll.
- Type a question for your poll.
- Type at least two options for your poll.
- Optionally, to add a extra poll options, click Add an option.
- Click Start poll.
组织讨论
Repository owners and people with write access to the repository can create new categories to keep discussions organized. Similarly, since organization discussions are based on a source repository, repository owners and people with write access to the source repository can create new categories for organization discussions.
参与和创建新讨论的协作者可以将讨论分组到最相关的现有类别。 讨论也可以在创建后重新分类。 For more information, see "Managing categories for discussions."
为了更精细地组织讨论，您可以应用标签。 例如，您可以使用标签来表示讨论的状态，以提高分类效率。 每个仓库都有一组用于议题、拉取请求和讨论的共享标签。 更多信息请参阅“管理标签”。
促进健康的对话
People with write permissions for the repository, or for the source repository for organization discussions, can help surface important conversations by pinning discussions, deleting discussions that are no longer useful or are damaging to the community, and transferring discussions to more relevant repositories owned by the organization. For more information, see "Managing discussions."
People with triage permissions for the repository, or for the source repository for organization discussions, can help moderate a project's discussions by marking comments as answers, locking discussions that are no longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. 更多信息请参阅“主持讨论”。
后续步骤
一旦有明确的路径来确定范围以及将想法从概念变为现实，您就可以创建议题并开始跟踪进度。 有关从讨论创建议题的更多信息，请参阅“主持讨论”。