Skip to content

Merge Category:Subgroups and Category:Projects to Category:Groups & Projects

Summary

Merging two categories and renaming the resulting category.

~"Category:Projects" is merging into ~"Category:Subgroups", see also Merge Category:Subgroups and Category:Projects ... (gitlab-com/www-gitlab-com#14554 - closed). The resulting category is renamed to Category:Groups & Projects. Required actions:

  • Migrate all resources labeled with ~"Category:Projects" by applying Category:Groups & Projects and removing ~"Category:Projects". There might be issues that already carry the Category:Groups & Projects label. In these cases, ~"Category:Projects" an simply be removed.
  • Rename ~"Category:Subgroups" to Category:Groups & Projects
  • Deprecate the ~"Category:Projects" label by appending [DEPRECATED] to the title, update the label description and schedule a date for removal.

Running on-off label migration is necessary because Category:Groups & Projects already exists, so we cannot simply rename ~"Category:Projects" to Category:Groups & Projects.

For every case above, please ensure that:

  • The label change is factored into the triage mechanism with updated spec fixtures.
  • Old labels are migrated correctly on affected issues, merge requests and epics.

Action items for issue author

  • Provide link to the merge request in www-gitlab-com for the label change. Link.
  • (If applicable) One-off label migration:
    • Refer to the label migration documentation to determine whether you need to run a one-off label migration, and to self-serve the migration task if possible. If you don't feel the documentation is sufficient to enable you to self-serve this request, indicate in the issue what is missing and we will improve.
  • (If applicable) Archive the old label with renaming and adding "DEPRECATED" at the end of the label name.
  • (If applicable) Update the label's description with link to the updated handbook page.
  • (If applicable) Update the group-definition.yml with the new group name.

Action items for Engineering Productivity

  • Ensure the issue author has completed the action item checklist.
  • Address any feedback left for the label migration documentation for improvements.

/cc @gl-quality/eng-prod @gitlab-org/quality/engineering-analytics

Edited by Arturo Herrero