As a result of the FY2022Q3 OKR, Balance tech writer workload by improving the planning and estimation process for feature docs, we determined that the following plan would help us begin to consolidate release planning for the TW team.
Why is release planning for the tech writing team important? First, we are almost entirely reactive. Our workflow has writers constantly responding to developer reviews to update the docs. We don't have a consistent planning process across the team. That makes it hard for us to estimate our capacity. Second, we also have had a long-standing focus on Improvement MRs (now called Maintenance.) How do we plan for OKRs, improvement projects, and backlog items if we don't understand what's coming for release docs? All of this contributes to the question: How do we know when we have the correct number of writers on the team?
Beginning to understand what's coming in each release across stages will help us plan for more Improvement projects and OKRs, such as the CTRT OKR already scheduled. We know findability is a problem on the docs site, and that users struggle to figure out how to use GitLab. Moving from reactive to proactive working will benefit our users by allowing us to plan to focus on targeted improvements.
This issue provides a consolidated view of what the Technical Writing team expects to work on with their assigned groups for the upcoming milestone. In addition to the work with their assigned groups, the Technical Writing team also works on OKRs and other tasks that are not reflected in this issue.
By the 15th
of each month:
One of the TW Managers creates the issue for the upcoming milestone.
By the 29th
of each month:
The TW carries out the following planning activities for their assigned groups, and populates Checklist and links to confirm these activities have taken place:
-
Have a conversation - synchronously or asynchronously - with either the group PM or EM to review planned documentation and ~"UI text" work for the upcoming milestone (Milestone: Upcoming
) or (Milestone: Started
). This is also an opportunity to talk to the PM or EM about any improvement or development opportunities they're aware of in their areas of the product documentation. This can be a regular group meeting or any other means of communication that you have established with your group.
-
Identify a linked artifact that describes the upcoming planned work, such as:
- An issue board for the group's documentation/UI text items for the milestone.
- A filter that describes/lists the planned work. (Example for ~"devops::plan")
- The group's planning issue, if it identifies issues/MRs that require Technical Writing team involvement. (Example)
-
Select the appropriate checkboxes and share the links to planned features to confirm that the "conversation" has taken place.
Checklist and links
Stage ~"devops::manage"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::access" |
Link to board or filter |
[ ] Yes |
~"group::workspace" |
Link to board or filter |
[ ] Yes |
~"group::compliance" |
Link to board or filter |
[ ] Yes |
~"group::import" |
Link to board or filter |
[ ] Yes |
~"group::optimize" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::plan"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::project management" |
Link to board or filter |
[ ] Yes |
~"group::product planning" |
Link to board or filter |
[ ] Yes |
~"group:certify" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::create"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::source code" |
Link to board or filter |
[ ] Yes |
~"group::code review" |
Link to board or filter |
[ ] Yes |
~"group::editor" |
Link to board or filter |
[ ] Yes |
~"group::gitaly" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::ecosystem"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::integrations" |
Link to board or filter |
[ ] Yes |
~"group::foundations" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::verify"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::pipeline execution" |
Link to board or filter |
[ ] Yes |
~"group::pipeline authoring" |
Link to board or filter |
[ ] Yes |
~"group::runner" |
Link to board or filter |
[ ] Yes |
~"group::testing" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::package"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::package" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::release"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::release" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::configure"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::configure" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::secure"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::static analysis" |
Link to board or filter |
[ ] Yes |
~"group::dynamic analysis" |
Link to board or filter |
[ ] Yes |
~"group::composition analysis" |
Link to board or filter |
[ ] Yes |
~"group::threat insights" |
Link to board or filter |
[ ] Yes |
~"group::vulnerability research" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::protect"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::container security" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::growth"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::activation" |
Link to board or filter |
[ ] Yes |
~"group::conversion" |
Link to board or filter |
[ ] Yes |
~"group::expansion" |
Link to board or filter |
[ ] Yes |
~"group::adoption" |
Link to board or filter |
[ ] Yes |
~"group::product intelligence" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::fulfillment"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"group::purchase" |
Link to board or filter |
[ ] Yes |
~"group::license" |
Link to board or filter |
[ ] Yes |
~"group::utilization" |
Link to board or filter |
[ ] Yes |
Stage ~"devops::enablement"
Group |
Link to board or filter |
Reviewed with PM or EM |
~"Distribution:Build" |
Link to board or filter |
[ ] Yes |
~"Distribution:Deploy" |
Link to board or filter |
[ ] Yes |
~"group::geo" |
Link to board or filter |
[ ] Yes |
~"group::memory" |
Link to board or filter |
[ ] Yes |
~"group::global search" |
Link to board or filter |
[ ] Yes |
~"group::database" |
Link to board or filter |
[ ] Yes |
~"group::sharding" |
Link to board or filter |
[ ] Yes |