Skip to content

stages.yml and categories.yml do not match

Currently, the gitlab-org/gitlab project pulls from data/stages.yml in order to generate a list of valid feature categories. The only issue is that this list requires that those categories be assigned to a group, and we have some categories that aren't. Instead we'd like to be able to pull categories from data/categories.yml, but that data doesn't match the data in data/stages.yml.

What's the best way to reconcile these two sources and keep them up to date? I think we probably want some kind of validation that the two have matching content, or at least that the contents of stages is a subset of the top level of categories.

Current mismatches (2022-12-21)

data/categories.yml includes (and stages does not):

  • api
  • gitlab_cli
  • gitlab_docs
  • gitlab_handbook
  • snippets
  • webhooks

data/stages.yml includes (and categories does not):

  • editor_extension
  • fulfillment_developer_productivity

Mismatched name:

  • Stages: code_review, Categories: code_review_workflow