Technical Writing milestone plan for 17.2
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 other tasks that are not reflected in this issue.
On the 1st
of each month:
The TW Bot creates the issue for the upcoming milestone using a scheduled pipeline.
We open this issue on the 1st to align with planning activities carried out by other teams and stakeholders. The 1st is on or around 12 days before the milestone begins. For example, for 16.8 (2024-01-17), the milestone starts on 2023-12-16 and we open this issue on 2023-12-01. For more information, see the product development timeline.
By the start of the milestone:
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
). - Improvement or development opportunities they're aware of in their areas of the product documentation.
- If any deprecations can be announced according to the process for deprecating and removing a feature. Deprecations should be announced as soon as possible, but the group should have a firm idea of deprecated features from about half-way through a major release cycle.
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.
- Planned documentation and UI text work for the upcoming milestone (
-
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-
groupimport and integrate - gitlab-org/manage/general-discussion#17674 (closed) -
grouppersonal productivity - Roadmap
devopsplan
Stage-
groupproject management - board | planning issue
-
groupproduct planning - board | planning issue
-
groupoptimize - board
devopscreate
Stage-
groupcode creation - Planning board, planning issue
-
groupcode review - board, Code Review 17.2 Planning : June (create-stage#13209 - closed) -
groupeditor extensions - board, Editor Extensions 17.2 Planning (gitlab-org/editor-extensions/meta#105 - closed) -
groupide - Remote Development board, Web IDE board -
groupsource code - board, planning issue
devopsverify
Stage-
grouppipeline authoring - Issue -
grouppipeline execution - Issue -
grouppipeline security - Issue -
grouprunner - issue -
grouphosted runners - issue
devopspackage
Stage-
grouppackage registry - Link to board or filter
-
groupcontainer registry - issue
devopsdeploy
Stage-
groupenvironments - Link to board or filter
devopsmonitor
Stage-
groupanalytics instrumentation - Link to board or filter
-
groupproduct analytics - board, issue
devopssecure
Stage-
groupstatic analysis - Planning issue -
groupdynamic analysis - Planning issue -
groupcomposition analysis - Planning issue -
groupvulnerability research - Link to board or filter
-
groupsecret detection - Planning issue
devopsgovern
Stage-
groupsecurity policies - Planning issue -
groupthreat insights - Planning issue -
groupcompliance - gitlab-org/govern/compliance/general#231 (closed) -
groupanti-abuse - Link to board or filter
-
groupauthentication - Planning board -
groupauthorization - Planning board
devopsfulfillment
StageAll Fulfillment groups: board
-
groupprovision - Link to board or filter
-
grouputilization - Link to board or filter
devopssystems
Stage-
group::distributionbuild / group::distributiondeploy - Link to board or filter
-
groupgeo - gitlab-org/geo-team/discussions#5116 (closed) -
groupgitaly - gitlab-org/gitaly-planning/release-planning#24 (closed)
devopsdata stores
Stage-
groupcloud connector - Link to board or filter
-
groupglobal search - issue -
grouptenant scale - board, issue
devopsplatforms
Stagedevopsai-powered
Stage-
groupai framework - Planning board - Planning issue -
groupai model validation - Planning board - Planning issue -
groupcustom models - Planning board - Planning issue -
groupduo chat - Planning board - Planning issue
devopsmodelops
Stage-
groupdataops - Link to board or filter
-
groupmlops - Planning issue
Other 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
Link to events and team efforts (hackathons, other events).
✂ UX Paper Cuts
Epic that links to UX Paper Cuts team planning issue for this milestone. Issues and MRs have regular stage/group labels.
TW recurring tasks
- Release Post structural check for 17.2: @marcel.amirault
- Monthly doc version: @aqualls
-
Docs project maintenance tasks:
- June: @eread
- July: @ashrafkhamis
- Review docs-only backlog issues
TW team KRs
- (Driven by PM): gitlab-com/gitlab-OKRs#6978
Other team KRs
List of KRs or projects from other teams with Technical Writing impact or involvement this quarter:
Stage and group | TW | Issue/KR |
---|---|---|
devopssystems groupgeo | @axil |
gitlab#389514 |
devopssystems groupdistribution | @axil, @eread |
https://gitlab.com/gitlab-com/gitlab-OKRs/-/work_items/7020, gitlab#458123 (closed) |
devopsmanage groupimport and integrate |
@eread @ashrafkhamis
|
https://gitlab.com/gitlab-com/gitlab-OKRs/-/work_items/7449 |
devopssecure groupsecret detection | @rdickenson |
https://gitlab.com/gitlab-com/gitlab-OKRs/-/work_items/7095 |
Docs site work
- Issue board (ongoing work)