Create custom stage / group for tutorials section
Issue Description
In gitlab!96697 (comment 1086242972) @kpaizee asked if the files in /doc/tutorials/
could remain assigned to her so she is pinged about changes to them. These files currently have this metadata, and the lack of an owner is why the line was removed when we re-ran the CODEOWNERS task:
stage: none
group: unassigned
If I manually reassign /doc/tutorials/
back to Kati, we run the risk (ok, likelihood verging on certainty) that these changes will be overwritten the next time we run the script.
Proposal
The page's metadata links to https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments-to-other-projects-and-subjects and that page mentions Tutorials
as a group. Consider creating a new group in our CODEOWNERS task (/lib/tasks/gitlab/tw/codeowners.rake
) assigned to Kati, like this:
CodeOwnerRule.new('Tutorials', '@kpaizee'),
and add the faux group to all pages in that directory.
Ramifications
- Good: Kati will get notified for proposed changes to these pages.
- Unknown: this fake not-a-group will probably have ramifications to Suzanne's content audit spreadsheet.
Related issues
These issues and MRs describe the evolution of the CODEOWNERS project for the Technical Writing team, from the initial idea through multiple (!) iterations to a finished product. These links may have been added significantly after this issue or merge request was closed, so they may describe parts of the process before or after this work.
- Related to Create rake task for docs CODEOWNERS (gitlab!77715 - merged) where Amy had an idea
- Related to Update CODEOWNERS to include TW assignments for... (gitlab!77606 - merged) where we asked for the raw output of the Rake task to be added into the CODEOWNERS file. This rake task would give the TW team a way to periodically generate a full list of owned pages.
- Related to Expand CODEOWNERS with more documentation DRIs (gitlab#349587 - closed) where Marcel noted many pages needed a DRI declared
- Related to Update CODEOWNERS to include TW assignments for... (gitlab!77606 - merged) where we started manually shortening the results
- Related to Refine how to run batch updates for the CODEOWN... (#668 - closed) where we started figuring out how to run batch updates
- Related to Codeowners: Assign TW with more than 50% page o... (gitlab#375783 - closed) where we started automating the process of shortening and condensing the results
- Related to Document tw::codeowners rake task (#598 - closed) where we documented the task
- Related to Create custom stage / group for tutorials section (#672 - closed) where we had to find alternate assignments for part of the docset that is owned, but not by a stage/group
- Related to Release Post 15.7 MVP Nominations (gitlab-com/www-gitlab-com#14283 - closed) where Niklas was nominated as MVP for the months of iteration needed to bring this script to a full, workable state