Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

在 GitHub 上通信

您可以在 GitHub Enterprise Server 中使用不同类型的讨论来讨论特定项目和更改,以及更广泛的想法或团队目标。

简介

GitHub Enterprise Server 提供内置的协作通信工具,使您能够与社区进行密切互动。 此快速入门指南将指导您如何根据您的需求选择合适的工具。

可以根据想参加的对话类型创建并参与问题、拉取请求、GitHub Discussions 和团队讨论。

GitHub Issues

  • 适用于讨论项目的具体细节,如漏洞报告、计划的改进和反馈。
  • 是特定于存储库的,通常有一个明确的所有者。
  • 通常被称为 GitHub 的错误跟踪系统。

拉取请求

  • 允许您提出具体的更改。
  • 允许您直接评论其他人建议的更改。
  • 是特定于仓库的。

团队讨论

  • 可以在您的团队页面上启动跨项目的对话,不属于特定的议题或拉取请求。 不要在仓库中开启一个议题来讨论一个想法,而可以通过在团队讨论中进行对话将整个团队包括在内。
  • 允许您与您的团队在一个地方就规划、分析、设计、用户研究和一般项目决策进行讨论。
  • 在代码库之外提供协作体验,从而可以集思广益。
  • 往往没有明确的所有者。
  • 通常不会导致可操作的任务。

我应该使用哪种讨论工具?

议题场景

  • 我想跟踪任务、增强功能和漏洞。
  • 我想提交错误报告。
  • 我想分享有关特定功能的反馈。
  • 我想询问有关仓库文件的问题。

问题示例

此示例说明了 GitHub 用户如何在我们的文档开源仓库中创建议题,以便让我们了解错误并讨论修复方法。

议题实例

  • 用户注意到,中文版 GitHub 文档页面顶部横幅的蓝色使横幅中的文本不可读。
  • 用户在仓库中创建一个议题,指出了问题并提出了修复建议(即对横幅使用不同的背景色)。
  • 随后进行了讨论,最终就适用的修复方法达成共识。
  • 然后,参与者可以创建包含修复方法的拉取请求。

拉取请求场景

  • 我想修复仓库中的拼写错误。
  • 我想对仓库进行更改。
  • 我想进行更改以修复问题。
  • 我想评论其他人建议的更改。

拉取请求示例

此示例说明了 GitHub 用户如何在我们的文档开源仓库中创建拉取请求以修复拼写错误。

在拉取请求的“对话”选项卡,作者解释了其创建拉取请求的原因。

拉取请求示例 - 对话选项卡

拉取请求的“文件更改”选项卡显示已实现的修补程序。

拉取请求示例 - 文件已更改选项卡

  • 此参与者发现仓库中的拼写错误。
  • 用户创建包含修复方法的拉取请求。
  • 仓库维护员审查拉取请求、发表评论并合并它。

GitHub Discussions 的场景

  • 我有一个不一定与仓库中的特定文件相关的问题。
  • 我想与协作者或团队分享消息。
  • 我想发起或参与开放式对话。
  • 我想向社区发布公告。

GitHub Discussions 示例

此示例显示了 GitHub 文档开源仓库的 GitHub Discussions 欢迎帖子,并说明了团队希望如何与社区合作。

GitHub Discussions 示例

这位社区维护员发起讨论以欢迎社区成员,并请成员自我介绍。 这个帖子营造了欢迎访客和参与者的氛围。 这个帖子还阐明,团队乐于帮助用户参与仓库。

团队讨论场景

  • 我有一个不一定与仓库中的特定文件相关的问题。
  • 我想与协作者或团队分享消息。
  • 我想发起或参与开放式对话。
  • 我想向团队发布公告。

团队讨论示例

此示例显示 octo-team 团队的团队帖子。

团队讨论示例

octocat 团队成员发布了团队讨论,告知团队各种事项:

  • 一个叫 Mona 的团队成员开始了远程游戏活动。
  • 有一篇博文描述了团队如何使用 GitHub Actions 来生成文档。
  • 有关 April All Hands 的材料现在可供所有团队成员查看。

后续步骤

这些示例向您展示了如何决定哪种工具是您在 GitHub Enterprise Server 上进行对话的最佳工具。 但这仅仅是个开始;您可以做更多的工作来根据需求定制这些工具。

例如,对于议题,您可以用标签标记议题以支持更快的搜索,并创建议题模板以帮助参与者打开有意义的议题。 有关详细信息,请参阅“关于问题”和“关于问题和拉取请求模板”。

对于拉取请求,如果您提议的更改仍在进行中,您可以创建拉取请求草稿。 草稿拉取请求在标记为可供审查之前无法合并。 有关详细信息,请参阅“关于拉取请求”。

对于 GitHub Discussions,可以将包含社区重要信息的讨论置顶。 有关详细信息,请参阅“关于讨论”。

对于团队讨论,您可以编辑或删除团队页面上的讨论,还可以为团队讨论配置通知。 有关详细信息,请参阅“关于团队讨论”。

若要了解一些有助于传达的高级格式设置功能,请参阅“在 GitHub 上进行编写的快速入门”。