Help us learn about your current experience with the documentation. Take the survey.

教程:为问题分类设置包含多个项目的组

  • Tier: 免费版、高级版、旗舰版
  • Offering: GitLab.com、GitLab 自托管、GitLab 专用

问题分类(issue triage)是按类型和严重程度对问题进行分类的过程。 随着项目的发展,人们创建的问题越来越多,值得创建一个工作流程来处理新进的问题。 在本教程中,您将学习如何为此场景设置一个包含多个项目的 GitLab 组。

在项目中设置 GitLab 进行问题分类:

  1. 创建组
  2. 在组内创建项目
  3. 确定类型、严重程度和优先级的标准
  4. 记录您的标准
  5. 创建作用域标签
  6. 为新标签设置优先级
  7. 创建组问题分类看板
  8. 为功能创建问题

开始之前

  • 如果您使用现有项目进行本教程,请确保您至少拥有项目的 Reporter 角色。

创建组

本质上是多个项目的容器。它允许用户同时管理多个项目并与组员沟通。

要创建新组:

  1. 在左侧边栏顶部,选择 新建 ( plus ),然后选择 新建组
  2. 选择 创建组
  3. 输入组详细信息。
    • 对于 组名称,输入 triage-tutorial
  4. 在页面底部选择 创建组

在组内创建项目

要管理多个项目的问题跟踪,您需要在组内创建至少两个项目。

要创建新项目:

  1. 在左侧边栏顶部,选择 新建 ( plus ) 和 新项目/仓库
  2. 选择 创建空白项目
  3. 输入项目详细信息:
    • 对于 项目名称,输入 test-project-1。更多信息,请参见项目命名规则
  4. 在页面底部选择 创建项目
  5. 重复此过程创建第二个名为 test-project-2 的项目。

确定类型、严重程度和优先级的标准

接下来,您需要确定:

  • 您想要识别的问题 类型。如果您需要更细粒度的方法,还可以为每种类型创建子类型。类型有助于对工作进行分类,以了解团队被要求完成的工作类型。
  • 优先级严重程度的级别,以定义新工作对最终用户的影响,并帮助进行优先级排序。

在本教程中,假设您已决定如下:

  • 类型:BugFeatureMaintenance
  • 优先级:1234
  • 严重程度:1234

作为参考,请查看我们在 GitLab 中如何定义这些:

记录您的标准

在您就所有标准达成一致后,将其记录在团队成员始终可以访问的地方。

例如,将其添加到您项目中的 wiki,或使用 GitLab Pages 发布的公司手册中。

创建作用域标签

  • 版本:高级版、旗舰版
  • 提供:GitLab.com、GitLab 自托管、GitLab 专用

接下来,您将创建标签以添加到问题中进行分类。

最好的工具是 作用域标签,您可以使用它来设置互斥属性。

根据您之前 确定的 类型、严重程度和优先级列表,您需要创建相应的作用域标签。

作用域标签名称中的双冒号 (::) 防止同时使用同一作用域的两个标签。 例如,如果将 type::feature 标签添加到已有 type::bug 标签的问题上,之前的标签将被移除。

作用域标签在高级版和旗舰版中可用。 如果您使用的是免费版,可以使用普通标签代替。 但是,它们不是互斥的。

要创建每个标签:

  1. 在左侧边栏,选择 搜索或跳转 并找到您的组。
  2. 选择 管理 > 标签
  3. 选择 新建标签
  4. 标题 字段中,输入标签名称。从 type::bug 开始。
  5. 可选。从可用颜色中选择,或在 背景颜色 字段中输入特定颜色的十六进制颜色值。
  6. 选择 创建标签

重复步骤 3-6 创建您需要的所有标签。 以下是一些示例:

  • type::bug
  • type::feature
  • type::maintenance
  • priority::1
  • priority::2
  • priority::3
  • priority::4
  • severity::1
  • severity::2
  • severity::3
  • severity::4

为新标签设置优先级

现在,将新标签设置为优先级标签。 这样做可以确保,如果您按优先级或标签优先级排序,最重要的问题会显示在问题列表的顶部。 要了解按优先级或标签优先级排序时会发生什么,请参见排序和排序问题列表

要为标签设置优先级:

  1. 在标签页面上,在您要设置优先级的标签旁边,选择 优先级 ( star-o )。该标签现在会出现在标签列表顶部,位于 优先级标签 下。
  2. 要更改这些标签的相对优先级,在列表中上下拖动它们。列表中较高的标签具有更高的优先级。
  3. 为您之前创建的所有标签设置优先级。 确保优先级和严重程度较高的标签在列表中的位置高于优先级和严重程度较低的标签。

十一个优先级作用域标签的列表

创建组问题分类看板

为准备即将到来的问题积压,创建一个按标签组织问题的问题看板。您将使用它通过将卡片拖动到各种列表来快速创建问题并为其添加标签。

要设置您的问题看板:

  1. 确定看板的范围。 例如,创建一个组问题看板,用于为问题分配严重程度。
  2. 在左侧边栏,选择 搜索或跳转 并找到您的 triage-tutorial 组。
  3. 选择 计划 > 问题看板
  4. 在问题看板页面的左上角,选择包含当前看板名称的下拉列表。
  5. 选择 新建看板
  6. 标题 字段中,输入 问题分类(按严重程度)
  7. 保持选中 显示打开列表 复选框,并取消选中 显示已关闭列表
  8. 选择 创建看板。您应该会看到一个空的看板。
  9. severity::1 标签创建一个列表:
    1. 在问题看板页面的右上角,选择 创建列表
    2. 在出现的列中,从 下拉列表中选择 severity::1 标签。
    3. 在列表底部,选择 添加到看板
  10. severity::2severity::3severity::4 标签重复上一步。

目前,您看板中的列表应该是空的。接下来,您将用一些问题填充它们。

为功能创建问题

要跟踪即将推出的功能和错误,您必须创建一些问题。问题属于项目,但您也可以直接从组问题看板创建它们。

首先为计划的功能创建一些问题。您可以在发现错误时为其创建问题(希望不是太多!)。

要从您的 问题分类(按严重程度) 看板创建问题:

  1. 转到 打开 列表。 此列表显示不符合任何其他看板列表的问题。 如果您已经知道问题应该具有哪个严重程度标签,可以直接从该标签的列表中创建它。 请注意,从标签列表创建的每个问题都会被赋予该标签。 目前,我们将继续使用 打开 列表。

  2. 打开 列表上,选择 新建问题 图标 ( plus )。

  3. 完成字段:

    • 标题 下,输入 用户注册
    • 选择此问题适用的项目。我们将选择 test-project-1
  4. 选择 创建问题

  5. 重复这些步骤创建更多问题。

    例如,如果您正在构建应用程序,假设 test-project-1test-project-2 指的是应用程序的后端和前端。 创建以下问题,根据需要分配到项目:

    • 用户注册
    • 创建个人资料
    • 搜索功能
    • 添加到收藏
    • 推送通知
    • 社交分享
    • 应用内消息
    • 跟踪进度
    • 反馈和评分
    • 设置和偏好

您的第一个问题分类看板已准备就绪!通过将一些问题从 打开 列表拖动到其中一个标签列表来添加严重程度标签,尝试一下。

带有未标记问题和优先级 “严重程度” 标签的问题看板,用于标记问题

下一步

接下来,您可以:

  • 调整您使用问题看板的方式。一些选项包括:

    • 编辑您当前的问题看板,使其也包含优先级和类型标签的列表。 这样,您会使看板更宽,可能需要一些水平滚动。
    • 创建名为 问题分类(按优先级)问题分类(按类型) 的独立问题看板。 这样,您将保持不同类型的问题分类工作分开,但需要在看板之间切换。
    • 为团队交接设置问题看板
  • 在问题列表中按优先级或严重程度浏览问题,按每个标签过滤。 如果可用,请使用 “属于” 过滤运算符

  • 将问题分解为 任务

  • 使用 gitlab-triage gem 创建有助于自动化项目问题分类的策略。 生成带有以下热图的摘要报告:

    带有 “优先级” 和 “严重程度” 标签的问题对角线热图

要了解有关 GitLab 问题分类的更多信息,请参见问题分类分类操作