Technical Writing milestone plan for 15.5
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.
On the 15th
of each month:
The TW Bot creates the issue for the upcoming milestone.
By the 29th
of each month:
The TW carries out 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.If the TW, PM, or EM is unavailable around the beginning of the milestone, we encourage using async methods (like commenting in issues or Slack messages) or having conversations at an earlier time. If the conversation happens before the creation of the issue, just add the planning information to the issue when it's available.
-
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 devopsplan)
- 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
After you've reviewed the plan with your PM or EM, select the checkbox for your group. If you can't meet with the PM or EM for some reason (perhaps they're on PTO), append that information to the end of the line and leave the checkbox cleared.
devopsmanage
Stage-
~"group::authentication and authorization" - gitlab-org/manage/general-discussion#17557 -
~"group::workspace" - Planning issue, board. -
~"group::import" - gitlab-org/manage/general-discussion#17562 -
groupoptimize - Board
devopsplan
Stage-
groupproject management - Board | Planning issue -
groupproduct planning - Board | Planning issue -
~"group::certify" - Board | Planning issue
devopscreate
Stage-
groupsource code - board, create-stage#13039 (closed) -
groupcode review - board, create-stage#13042 (closed), create-stage#13046 (closed) -
~"group::editor" - board, issue
Stage ~"devops::ecosystem"
-
~"group::integrations" - board, issue -
groupfoundations - https://gitlab.com/gitlab-org/ecosystem-stage/team-tasks/-/issues/170
devopsverify
Stage-
grouppipeline authoring - Pipeline Authoring 15.5 Planning issue (gitlab-org/ci-cd/pipeline-authoring#69 - closed) -
grouppipeline execution - Pipeline Execution 15.5 Planning Issue (gitlab-org/ci-cd/pipeline-execution#112 - closed) -
~"group::pipeline insights" - https://gitlab.com/gitlab-org/ci-cd/pipeline-insights-group/-/issues/100+ -
grouprunner - gitlab-runner#28975 (closed)
devopspackage
Stage-
~"group::package" - gitlab#368535 (closed)
Stage ~"devops::release"
-
~"group::release" - gitlab-org/ci-cd/release-group/release#158 (closed)
Stage ~"devops::configure"
-
~"group::configure" - 15.5 board
devopsmonitor
Stagedevopssecure
Stage-
groupstatic analysis - 15.5 Planning - Static Analysis (gitlab#373322 - closed) -
groupdynamic analysis - 📐 Dynamic Analysis - 15.5 Planning (gitlab#373267 - closed) -
groupcomposition analysis - 15.5 planning - Composition Analysis (September... (gitlab-org/secure/general#233 - closed) -
groupvulnerability research - Board
devopsgovern
Stage-
groupsecurity policies - Board and Issue -
groupthreat insights - Board -
groupcompliance - gitlab-org/govern/compliance/general#25 (closed)
Stage ~"devops::analytics"
-
~"group::product intelligence" - https://gitlab.com/gitlab-org/product-intelligence/-/issues/608 -
groupproduct analytics - gitlab-org/analytics-section/product-analytics/general-discussion#5 (closed)
devopsgrowth
Stagedevopsfulfillment
Stage-
~"group::purchase" - Board -
groupprovision - Board -
grouputilization - BE board, FE board -
~"group::billing and subscription management" - Planning issue and board.
devopssystems
Stage-
~"Distribution:Build" - Link to board or filter
-
~"Distribution:Deploy" - Link to board or filter
-
groupgeo - Link to board or filter
-
groupgitaly - gitlab-org/gitaly-planning/release-planning#3 (closed)
Stage ~devops::data_stores
-
~"group::application performance" - Link to board or filter
-
groupglobal search - board, issue -
groupdatabase - board, planning issue
-
~"group::pods" - Link to board or filter
devopsanti-abuse
StageOther events and team efforts this milestone
-
Managers (@kpaizee, @dianalogan) check the Developer Evangelism calendar for Hackathons and other events that may impact team velocity this milestone. List the events and dates, and let the team know in the tw-team
Slack channel, and as a read-only in the TW Team meeting.
Events
- F & F 2022-09-26 and 2022-10-07
- Visiting Grant trips
- 2022-10-04 - 2022-10-05 @marcel.amirault (half days on 10-03 and 10-06 due to travel to/from location).
- 2022-10-05 - 2022-10-06 @dianalogan
- 2022-10-09 - 2022-10-12 @msedlakjakubowski @lciutacu @fneill
Coverage
- @rdickenson #674 (closed)
- @axil #663 (closed)
- @eread https://gitlab.com/gitlab-org/technical-writing/-/issues/683
TW recurring tasks
- Release Post structural check: @claytoncornell
- Monthly doc version: @fneill
- Docs project maintenance tasks: @marcel.amirault
TW team KRs
- Q3FY23 KR: Improve findability, organization, and learnability of GitLab content by refactoring docs pages - team
- Q3FY23 KR: Improve the Cloud Native install documentation to support teams that want to run GitLab in Kubernetes - Suzanne, Axil, Diana
Docs-only backlog by stage
** Informational only this milestone **
-
New issue board showing recent (through 2021) docs-only backlog issues by stage.
-
Activities we're considering for next milestone/quarter:
- Review issues on your "personal" backlogs for correct labels.
- Review pre-2021 issues for closure/correct labels.