GitHub 是协作平台

已完成

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

在本单元中,我们将了解问题和讨论。 这是构成 GitHub Enterprise Platform 的协作性质的另外两个部分。

问题

创建 GitHub 问题的目的是跟踪想法、反馈、任务或 bug,从而更好地使用 GitHub。 可通过各种方式创建问题,以便为工作流选择最方便的方法。

在本演练中,我们将介绍如何从存储库创建问题。 但也可以从以下位置创建问题:

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

从仓库创建议题

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

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

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

  3. 选择“新建问题”。

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

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

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

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

  6. 在“添加描述”字段中,输入问题的描述内容。

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

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

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

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

讨论

讨论适合需要可供所有人访问且与代码无关的对话。 讨论使公共论坛中能够进行流畅、公开的对话。

在本部分中,我们将介绍:

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

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

在存储库中启用讨论

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

首次启用 GitHub 讨论时,系统会邀请你配置欢迎帖子。

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

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

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

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

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

  4. 在“开始新的讨论下,编辑模板,其中设置的资源和基调与希望为社区设置的保持一致。

  5. 选择“开始讨论”。

现在已准备好新建讨论。

新建讨论

任何可以查看存储库的经过身份验证的用户都可以在该存储库中创建讨论。 同样,由于组织讨论基于源存储库,因此任何可以查看源存储库的已通过身份验证的用户都可以在该组织中创建讨论。

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

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

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

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

  4. 通过选择“开始”选择讨论类别。 所有讨论都必须在类别中创建。 对于存储库讨论,由对存储库具有维护权限或管理员权限的人员定义该存储库中讨论的类别。

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

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

类别 用途 Format
📣 公告 项目维护者提供的最新消息和新闻 公告
#️⃣ 常规 与项目相关的任何及所有内容 开放式讨论
💡 想法 改变或改进项目的想法 开放式讨论
🗳 投票 提供多个选项的投票,供社区进行投票和讨论 投票
🙏 问答 供社区回答的问题,使用问题/回答的形式 问答
🙌 展示和说明 与项目有关的创作、试验或测试 开放式讨论
  1. 在“讨论标题”下键入讨论标题,然后在“写入”下键入讨论正文。

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

  2. 选择“开始讨论”。

这涵盖了一些关于 GitHub 如何激发协作的内容。 现在,我们来了解如何管理通知、订阅会话以及开始使用 GitHub 页面。