Document how, and review/update Product sections, stages, and groups

Our Product Section, Stage, Group information is out of date. We should update it to be current. We also need to better document how to.

Current Product groups

Review sheet

Things that need updating

Content:

Action items

  1. Add redirect for moved page: https://gitlab.com/gitlab-com/content-sites/handbook/-/blob/9f2a9f655f28e44913119491dfdc002cecb3b15f/content/handbook/engineering/infrastructure-platforms/developer-experience/development-analytics/create-triage-policy-with-gitlab-duo-workflow-guide.md to https://docs.gitlab.com/development/duo_workflow/create_triage_policy_with_gitlab_duo_workflow_guide/ | gitlab-com/content-sites/handbook!15095 (merged)
  2. Update triage-ops template: https://gitlab.com/gitlab-org/quality/triage-ops/-/blob/master/.gitlab/issue_templates/category-stage-group-label-change.md | gitlab-org/quality/triage-ops!3530 (merged) & gitlab-org/quality/triage-ops!3565 (merged)
  3. Create issue template and remove overlap from https://gitlab.com/gitlab-com/www-gitlab-com/-/blob/master/.gitlab/merge_request_templates/Group-Stage-Category-Change.md | www-gitlab-com!140522 (merged)
  4. Update handbook: https://handbook.gitlab.com/handbook/product/categories/#changes | gitlab-com/content-sites/handbook!15222 (merged)
  5. Add gitlab-org/gitlab template for code changes | gitlab-org/gitlab!201049 (merged)
  6. Update approval rules/codeowners in www-gitlab-com | www-gitlab-com!140605 (merged)
  7. Add task to onboarding/offboarding/internal movement templates to ensure pointing to the right place on updating group members | https://gitlab.com/gitlab-com/people-group/people-operations/employment-templates/-/merge_requests/3265
  8. Ensure all necessary changes are completed
  9. Fix a display issue for who the Technical Writier is when it's the Slack channel: gitlab-com/content-sites/handbook!15546 (merged)

Add linter validation

To enforce consistency and validity of changes, we should add further functionality to the linters:

  1. Check name/username matches a team member file
    1. Add stages manager name validation (www-gitlab-com!139730 - merged)
    2. Properly forbid '@' prefix in stages.yml and ch... (www-gitlab-com!139781 - merged)
    3. Check usernames/names in stages.yml against act... (www-gitlab-com!139856 - merged)
    4. Check usernames/names in stages.yml against act... (www-gitlab-com!140218 - merged)
  2. Check that team tags match
    1. Add sections to team tags (www-gitlab-com!138565 - merged)
    2. Move section team tags and clean up departments (www-gitlab-com!138570 - merged)
    3. Add lint:team_yml:team_tags to lint:team_yml:all (www-gitlab-com!139867 - merged)
  3. Categories validation
    1. Add categories validations (www-gitlab-com!140118 - merged)
    2. Add required fields and stages validation (www-gitlab-com!140155 - merged)
    3. Add categories cross-checking (www-gitlab-com!140427 - merged)
    4. Add single stage per category verification (www-gitlab-com!140635 - merged)
    5. Add link requirement and unknown category isola... (www-gitlab-com!140661 - merged)
  4. Require (display) name field Add name validation and spec tests (www-gitlab-com!140405 - merged)
  5. Require/check section in stages Add section requirement (www-gitlab-com!140420 - merged)
  6. Features validation Add link requirement and unknown category isola... (www-gitlab-com!140661 - merged)
  7. Direction path validation
    1. Refactor direction path generator (to reuse the methods): Refactor direction path generation to share met... (www-gitlab-com!140703 - merged)
    2. Spec tests: Add direction path generator spec tests (www-gitlab-com!140760 - merged)
    3. Section/Stages direction path validation: Add direction path validation and spec test (www-gitlab-com!140746 - merged)
Edited by Cynthia "Arty" Ng