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

教程:设置用于问题分类的复杂群组及其子群组

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

问题分类是根据类型和严重程度对问题进行分类的过程。 随着项目的发展,人们创建的问题越来越多,值得创建一个工作流程来处理新进来的问题。

在本教程中,你将学习如何为这种情况设置带有子群组的 GitLab 群组。

要为问题分类设置带有子群组的复杂 GitLab 群组:

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

开始之前

  • 如果你在本教程中使用现有项目,请确保你至少拥有该项目的 Reporter 角色

创建群组

群组 本质上是多个项目的容器。 它允许用户一次性管理多个项目并与群组成员沟通。

要创建新群组:

  1. 在左侧边栏顶部,选择 创建新内容 ( plus ) 并选择 新群组
  2. 选择 创建群组
  3. 输入群组详情:
    • 对于 群组名称,输入 Web App Dev 或其他值。
  4. 在页面底部,选择 创建群组

在群组内创建子群组

子群组 是群组中的群组。 子群组有助于组织大型项目和管理权限。

要创建新子群组:

  1. 在左侧边栏,选择 搜索或跳转 并找到你的 Web App Dev 群组。
  2. 选择 创建新内容 ( plus ) 并选择 新子群组
  3. 输入子群组详情:
    • 对于 子群组名称,输入 Frontend 或其他值。
  4. 选择 创建子群组
  5. 重复此过程创建第二个名为 Backend 或其他值的子群组。

在子群组中创建项目

要管理跨多个项目的问题跟踪,你需要在子群组中创建项目。

要创建新项目:

  1. 在左侧边栏,选择 搜索或跳转 并找到你的 Frontend 子群组。
  2. 在左侧边栏顶部,选择 创建新内容 ( plus ) 并选择 新项目/仓库
  3. 选择 创建空白项目
  4. 输入项目详情:
    • 对于 项目名称,输入 Web UI。更多信息,请参阅项目 命名规则
  5. 在页面底部,选择 创建项目
  6. 重复此过程在 Frontend 子群组中创建第二个名为 Accessibility Audit 的项目,以及在 Backend 子群组中创建第三个名为 API 的项目。

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

接下来,你需要确定:

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

对于本教程,假设你已经决定如下:

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

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

记录你的标准

当你同意所有标准后,把它们写下来放在团队成员总能访问的地方。

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

创建作用域标签

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

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

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

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

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

作用域标签在 Premium 和 Ultimate 版本中可用。如果你使用的是 Free 版本,可以使用普通标签代替。但是,它们不是互斥的。

要让标签在所有子群组的项目中可用,首先进入包含你的子群组的父群组。如果你希望标签只在特定子群组的项目中可用,则从子群组内部执行这些步骤。

要创建每个标签:

  1. 在左侧边栏,选择 搜索或跳转 并找到你的 Web App Dev 群组。
  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. 在左侧边栏,选择 搜索或跳转 并找到你的 Web App Dev 群组。
  3. 选择 计划 > 问题看板
  4. 在问题看板页面的左上角,选择包含当前看板名称的下拉列表。
  5. 选择 创建新看板
  6. 标题 字段中,输入 问题分类(按严重程度)
  7. 保持 显示开放列表 复选框选中,并清除 显示已关闭列表 复选框。
  8. 选择 创建看板。你应该会看到一个空的看板。
  9. severity::1 标签创建一个列表:
    1. 在问题看板页面的右上角,选择 创建列表
    2. 在出现的列中,从 下拉列表中选择 severity::1 标签。
    3. 在列表底部,选择 添加到看板
  10. severity::2severity::3severity::4 标签重复上一步。

要创建子群组问题看板,从子群组内部执行步骤 3-10。

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

为功能创建问题

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

首先为计划的功能创建一些问题。当你发现错误时,可以为它们创建问题(希望不会太多!)。

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

  1. 进入 开放 列表。 此列表显示不符合任何其他看板列表的问题。 如果你已经知道你的问题应该具有哪个严重程度标签,可以直接从该标签的列表中创建。 请注意,从标签列表创建的每个问题都会被赋予该标签。

    目前,我们将继续使用 开放 列表。

  2. 开放 列表中,选择 创建新问题 图标 ( plus )。

  3. 完成字段:

    • 标题 下,输入 Dark mode toggle
    • 选择此问题适用的项目。我们将选择 Frontend / Web UI
  4. 选择 创建问题

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

    例如,如果你正在构建 Web API 应用,FrontendBackend 指的是不同的工程团队。项目指的是堆栈开发的不同方面。创建以下问题,根据需要分配给项目:

    • User registration
    • Profile creation
    • Search functionality
    • Add to favorites
    • Push notifications
    • Social sharing
    • In-app messaging
    • Track progress
    • Feedback and ratings
    • Settings and preferences

一个项目的问题看板中的问题无法从其他项目的问题看板中看到。同样,一个子群组中的项目问题只能在该子群组的问题看板中看到。要查看父群组中所有项目的问题,你必须位于父群组的问题看板中。

你的第一个问题分类看板已经准备好了!试试看,通过将一些问题从 开放 列表拖到其中一个标签列表来添加一个严重程度标签。

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

下一步

接下来,你可以:

  • 调整你使用问题看板的方式。一些选项包括:
    • 编辑你当前的问题看板,使其也包含优先级和类型标签的列表。这样,你会使看板更宽,可能需要一些水平滚动。
    • 创建名为 问题分类(按优先级)问题分类(按类型) 的独立问题看板。这样,你会将不同类型的工作分类分开,但需要在看板之间切换。
    • 为团队交接设置问题看板
  • 在问题列表中按优先级或严重程度浏览问题,按每个标签过滤。如果对你可用,请使用 “是其中之一” 过滤运算符
  • 将问题分解为 任务
  • 使用 gitlab-triage gem 创建帮助自动项目问题分类的策略。生成如下所示的带有热图的摘要报告:

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

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