FY23Q4 TW OKR: Review and clean up documentation backlog for future focused efforts => 95%
The documentation backlog has not been reviewed and cleaned up for quite a while. To be able to present a clear picture of essential backlog work, we need to complete this review.
Writers will review the backlog items that include their group labels.
Instructions
Review the issues in the pre-cleanup lists for your assigned groups
In the Backlog filters for cleanup section below, open the pre-cleanup link next to your group. For each issue:
-
Is it a docs-only issue? => apply the docs-only label.
-
Is the issue still relevant? If recent updates have addressed the issue => Comment and Close.
-
Is the issue more than 2 years old, with no recent activity, and relates to a docs-only update (not linked to a feature)? => Lean toward closing. Add a comment, for example:
[at mention issue author] there is no recent activity on this issue. We have no plans to address this issue in the near future, and are closing it. Feel free to reopen, or raise an MR with an update proposal.
-
Most docs-only backlog issues should also include: typemaintenance, maintenancerefactor. For the list of labels usually applied docs-only issues, see Documentation feedback and improvements. => apply missing labels.
-
Is this a good candidate for a community contributor? => apply labels Seeking community contributions, ~"good for new contributors". These labels can only be added to unassigned issues.
-
Is there a next step to get to an MVC? => Add comment or checklist task to the issue.
-
Add the twtriaged label.
-
Should we reschedule this from Backlog to Next 1-3 releases? => update Milestone.
-
If you are assigned to the issue, and are are not planning to work on the issue in the next 1-3 releases => unassign yourself.
Note: If you have >20-30 open issues in any one group, discuss MVC approaches with your manager. You might want to consider using the Issues API to automate the closure and labelling.
Share the docs-only backlog link
When you've finished reviewing and updating the issues for your groups:
- Replace the
cleaned up list link
,cleaned up issue count
placeholder text next to each group with the link to the issue list that shows documentation, docs-only,Milestone = Backlog
,=
typemaintenance,group name
, twtriaged, and the new issue count. For example, for ~"group::authentication and authorization", you'd use this query. - Check the box next to the group name below.
- Feel free to share with your groups, and continue discussions with the PM on prioritization.
Backlog filters for cleanup
For the pre-cleanup lists, we're using: documentation, Milestone = Backlog
, !=
typefeature, !=
typebug, group name
. Link.
At 2022-10-27, the total was 717. Out of 717, 605 have group labels.
For percentage calculations: 46 checkboxes below.
devopsmanage
Stage-
~"group::authentication and authorization" - Pre-cleanup list, 16 issues. Cleaned up list, 11 issues. -
~"group::organization" - Pre-cleanup list, 5 issues. Cleaned up list, 6 issues. -
~"group::import" - Pre-cleanup list, 11 issues. Cleaned up list link, 10 issues. -
groupoptimize - Pre-cleanup list, 5 issues. Cleaned up list, 1 issue. -
~"group::integrations" - Pre-cleanup list, 46 issues. Cleaned-up list, 24 issues. -
groupfoundations - Pre-cleanup list, 7 issues. Cleaned-up list, 2 issues.
devopsplan
Stage-
groupproject management - Pre-cleanup list, 19 issues. Cleaned up list, 8 issues. -
groupproduct planning - Pre-cleanup list, 11 issues. Cleaned up list, 4 issues. -
~"group::certify" - Pre-cleanup list, 1 issue. Cleaned up list, 0 issues.
devopscreate
Stage-
groupsource code - Pre-cleanup list, 87 issues. cleaned up list link
,cleaned up issue count
. -
groupcode review - Pre-cleanup list, 17 issues. cleaned up list link
,cleaned up issue count
. -
~"group::editor" - Pre-cleanup list, 38 issues. Cleaned-up list, 18 issues.
devopsverify
Stage-
grouppipeline authoring - Pre-cleanup list, 100 issues. Cleaned up (with tw::triaged
+docs-only
), 49 issues. -
grouppipeline execution - Pre-cleanup list, 50 issues. Cleaned up (with tw::triaged
+docs-only
), 25 issues. -
~"group::pipeline insights" - Pre-cleanup list, 5 issues. Untriaged, ~7 issues, Cleaned up (with tw::triaged
+docs-only
), 7 issues. -
grouprunner - Pre-cleanup list - in GitLab.org, 4 issues. Cleaned up list link, 0 issue | Pre-cleanup list - in Runner project, 11 issues. Cleaned up list link, 3 issues.
devopspackage
Stage-
groupcontainer registry - Pre-cleanup list, 1 issue. Cleaned up list, 2 issues. -
grouppackage registry - Pre-cleanup list, 12 issues. Still to clean up 2 issues, Cleaned up list, 9 issues.
Stage ~"devops::release"
-
~"group::release" - Pre-cleanup list, 8 issues. Cleaned-up list, 5.
Stage ~"devops::configure"
-
~"group::configure" - Pre-cleanup list, 18 issues. Cleaned list, 10 issues.
devopsmonitor
Stage-
grouprespond - Pre-cleanup list, 19 issues. Cleaned up list, 4 issues. -
groupobservability - Pre-cleanup list, 2 issues. Cleaned up list, 0 issues.
devopssecure
Stage-
groupstatic analysis - Pre-cleanup list, 16 issues. Cleaned-up list, 9. -
groupdynamic analysis - Pre-cleanup list, 4 issue. Cleaned-up list, 2. -
groupcomposition analysis - Pre-cleanup list, 13 issues. Cleaned-up list, 5. -
groupvulnerability research - Pre-cleanup list, 0 issues. Cleaned up list, 0 issues.
devopsgovern
Stage-
groupsecurity policies - Pre-cleanup list, 0 issues. Cleaned up list, 2 issues. -
groupthreat insights - Pre-cleanup list, 12 issues. Cleaned up list, 11 issues. -
groupcompliance - Pre-cleanup list, 2 issues. Cleaned up list link, 1 issue.
Stage ~"devops::analytics"
-
~"group::product intelligence" - Pre-cleanup list, 4 issues. Cleaned up list, 0 issues. -
groupproduct analytics - Pre-cleanup list, 0 issues. Cleaned up list, 0 issues.
devopsgrowth
Stage-
groupacquisition - Pre-cleanup list, 7 issues. Clean list, 0 issues. -
groupactivation - Pre-cleanup list, 0 issues. Cleaned up list link, 0.
devopsfulfillment
Stage-
~"group::purchase" - Pre-cleanup list, 1 issue. cleaned up list link, 0 issues. -
groupprovision - Pre-cleanup list, 2 issues. Cleaned up list link, 2 issues. -
grouputilization - Pre-cleanup list, 2 issues. cleaned up list link, 2 issues. -
groupfulfillment platform - Pre-cleanup list, 0 issues. cleaned up list link
,cleaned up issue count
. -
~"group::billing and subscription management" - Pre-cleanup list, 0 issues. cleaned up list link
,cleaned up issue count
.
devopssystems
Stage-
~"Distribution:Build" / ~"Distribution:Deploy" - Pre-cleanup list in GitLab.org, 11 issues | Charts, 14 issues | Omnibus, 21 issues. Cleaned up list in GitLab.org 2 issues | charts 7 issues, Omnibus 7issues. -
groupgeo - Pre-cleanup list, 37 issues. cleaned up list link, cleaned up issue count 19 issues. -
groupgitaly - Pre-cleanup list, 4 issues. Cleaned up list link, 4 issues.
Stage ~devops::data_stores
-
~"group::application performance" - Pre-cleanup list, 6 issues. Cleaned up list, 2 issues. -
groupglobal search - Pre-cleanup list, 14 issues. Cleaned-up list, 6 issues. -
groupdatabase - Pre-cleanup list, 1 issue. cleaned up list, 1. -
~"group::pods" - Pre-cleanup list, 1 issue. Cleaned up list, 0 issues.
devopsanti-abuse
Stage-
groupanti-abuse - Pre-cleanup list, 1 issue. Cleaned list, 0 issues.