GitHub 是协作平台

  • 8 分钟

协作是 GitHub 所做的一切的核心。 我们在模块的第一单元中介绍了存储库，并了解到存储库有助于组织项目及其文件。 在上一个单元，我们了解了拉取请求，这是跟踪项目更改的一种方法。

在本单元中，我们将了解问题和讨论。 这些功能有助于 GitHub Enterprise Platform 的协作性。

问题

GitHub 问题用于跟踪 GitHub 上工作的想法、反馈、任务或 bug。 可通过各种方式创建问题，以便为工作流选择最方便的方法。

本演练介绍如何从存储库创建问题。 还可以从以下项创建问题：

  • 任务列表中的项。
  • 项目中的备注。
  • 问题或拉取请求中的评论。
  • 特定代码行。
  • URL 查询。

从仓库创建议题

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在存储库名称下，选择“ 问题”。

    显示存储库主页顶部部分的屏幕截图，其中突出显示了“问题”部分。

  3. 选择 “新建问题”。

  4. 如果你的存储库使用的是问题模板，请在要打开的问题类型旁边选择“开始”。

    如果想要打开的问题类型未包含在可用选项中，请选择 “打开空白问题”。 如果不使用模板，请跳到步骤 5。

    如果存储库使用问题表单，你将看到一个结构化表单来填写，而不是空白问题模板。 问题表单允许维护人员以标准化格式收集特定信息。

    问题模板菜单的屏幕截图，其中突出显示了“打开空白问题”选项。

  5. 在 “添加标题 ”字段中，输入问题标题。

  6. 在 “添加说明 ”字段中，键入问题的说明。

  7. 如果你是项目维护者，可以将问题分配给某人、将其添加到项目板、将其与里程碑关联或应用标签。

  8. 完成后，选择“ 提交新问题”。

使用标签、提及和反应有效地管理协作，并提高问题可见性。 问题模板有助于保持参与者的一致结构和期望。

某些对话可能更适合 GitHub 讨论。 使用 GitHub 讨论来提问和回答问题、共享信息、发布公告以及进行或参与有关项目的对话。

在下一部分中，我们将查看讨论以及如何最好地利用该功能。

讨论

讨论专为不一定绑定到代码的对话而设计，例如 Q&A、想法或常规反馈。 它们支持在共享论坛中公开、持续进行的通信，并且可以是公共或专用的，具体取决于存储库的可见性。

此部分中，将了解如何：

  • 在存储库中启用讨论。
  • 创建新的讨论和各种讨论类别。

让我们深入了解在存储库中启用讨论。

在存储库中启用讨论

存储库所有者和具有写入访问权限的所有者可以为社区启用其公共和专用存储库上的 GitHub 讨论。 讨论的可见性从创建的存储库继承可见性。

首次启用 GitHub 讨论时，系统会提示你配置欢迎文章。

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在存储库名称下，选择“设置”。

    存储库主页顶部部分的屏幕截图，其中突出显示了“设置”部分。

  3. 向下滚动到 “功能 ”部分，然后在 “讨论”下，选择 “设置讨论”。

    “讨论”框的屏幕截图，其中突出显示了绿色的“设置讨论”按钮。

  4. 在 “开始新讨论”下，编辑模板以匹配社区的语气和资源。

  5. 选择 “开始讨论”。

现在已准备好新建讨论。

新建讨论

任何可以查看存储库的经过身份验证的用户都可以在该存储库中创建讨论。 对于组织级别的讨论，任何可以查看源存储库的用户也可以创建讨论。

  1. 在 GitHub.com 上，导航到要在其中开始讨论的存储库或组织的主页面。

  2. 在存储库或组织名称下，选择 “讨论”。

    存储库主页顶部部分的屏幕截图，其中突出显示了“讨论”部分。

  3. 在页面右侧，选择“ 新建讨论”。

  4. 通过选择 “入门”选择讨论类别。 所有讨论都必须放在一个类别中。 存储库维护人员定义这些类别。

    选择讨论类别菜单选择的屏幕截图，其中突出显示了顶部选项“公告”和“入门”按钮。

每个讨论类别都包含唯一的名称、表情符号和说明，以阐明其用途。 类别可帮助维护人员整理对话的归档方式。 可自定义它们以帮助区分类别，如 Q&A 或更开放式的对话。 下表显示了讨论的默认类别及其用途。

类别 目的 格式
📣 公告 项目维护者提供的最新消息和新闻 公告
#️⃣ 常规 与项目相关的任何及所有内容 开放式讨论
💡 想法 改变或改进项目的想法 开放式讨论
🗳 投票 提供多个选项的投票，供社区进行投票和讨论 投票
🙏 问答 供社区回答的问题，使用问题/回答的形式 问答
🙌 展示和说明 与项目有关的创作、试验或测试 开放式讨论

存储库维护人员可以将重要讨论固定到“讨论”选项卡顶部，以便获得更好的可见性。

  1. 在 “讨论”标题 下输入讨论标题，在 “写入” 下输入讨论正文。

    启动新的讨论页的屏幕截图，其中“讨论”标题框和内容框为空。

  2. 选择 “开始讨论”。

这包括 GitHub 如何通过问题和讨论支持协作。 现在，我们来了解如何管理通知、订阅会话以及开始使用 GitHub 页面。

将评论标记为答案

在问答样式讨论中，可以将批注标记为原始问题的答案。

  1. 导航到讨论。
  2. 找到最能回答原始问题的注释。
  3. 选择批注下方的 “标记为答案 ”。

将突出显示注释，使其他人能够快速找到解决方案。 还可以根据需要取消标记答案。

将讨论转换为问题

如果讨论导致需要跟踪的工作，则可以将讨论转换为问题。

  1. 导航到要转换的讨论。
  2. 选择 ... 讨论右上角的“三点”菜单。
  3. 选择“转换为问题”。
  4. 确认转换并选择存储库以创建新问题。

这会跟踪源自社区对话的可作工作。

固定讨论

可以将重要讨论固定到“讨论”页面顶部，以便获得更好的可见性。

  1. 导航到要固定的讨论。
  2. 选择 ... 讨论右上角的“三点”菜单。
  3. 选择 “固定讨论”。

固定的讨论有助于突出显示社区应注意的公告、重要问题或正在进行的主题。