Docs tutorial: How to do issue triage in GitLab
Problem statement
This issue captures the need for a tutorial, or workflow-style docs content, that shows users how to set up and use GitLab to manage development work for features and bugs. This came up in discussion with @s_awezec (PM on devopsgrowth) in the context of challenges with search results.
In the User docs, the Labels content is helpful, but there’s no tutorial content that walks you through all the areas you need to understand to do Prioritization and Severity tracking on issues. What the user/customer needs a more involved workflow showing how GitLab recommends setting up and using features to track bugs. You need to think about how to overlap multiple features i.e. creating labels either at the project or group level, should they create a bug template, what features are available in Premium/Ultimate that add additional value, like scoped labels.
MVC
MVC iterations could be:
-
Identify where we have existing sources of content that could help in this workflow and add them to Tutorials page in docs. For example, the Premium/Ultimate video content in https://gitlab.com/groups/gitlab-com/marketing/strategic-marketing/-/epics/397+ -
Single Project Create issue triage tutorial doc (!126384 - merged)
Published at https://docs.gitlab.com/ee/tutorials/issue_triage/ -
Single Group, multiple Projects - can be easily adapted from https://docs.gitlab.com/ee/tutorials/issue_triage/ -
Complex Group, Subgroup, Project hierarchy - can be easily adapted from https://docs.gitlab.com/ee/tutorials/issue_triage/
Implementation guide
To create the remaining tutorials, use !126384 (merged) as example, and copy and adapt the tutorial it added.