FY26Q1 Stage Lead planning issue: Plan
Issue description
This issue outlines the themes that will be the focus of the STAGE stage lead during Q1 of FY26.
Themes
Theme: Support the work items framework evolution
- Short description: Restructure documentation to reflect GitLab's transition to a unified work items framework while maintaining clarity for users.
- Reasoning: GitLab is moving towards a unified work items model, requiring documentation restructuring to reduce content duplication and improve user navigation. This aligns with the product's architectural changes and will help users understand the relationships between different work item types.
- Note: This work supports a major product direction shift and needs to be carefully coordinated with engineering milestones.
| Epic | Group(s) | Status | Effort | Priority | Details |
|---|---|---|---|---|---|
| Docs IA: Reorganize the "Plan and track work" section for unified work items | groupproject management groupproduct planning |
|
High | High | Target milestone is 17.10. Led by: Marcin |
Implemented issues and MRs:
- Docs: Create a "Work items" page (gitlab-org/gitlab#523418 - closed)
- Docs: Create a "Linked items" page (gitlab-org/gitlab#510355 - closed)
- Change how we link to new look docs (gitlab-org/gitlab!185312 - merged)
Theme: Improve core feature documentation
- Short description: Enhance accuracy and completeness of fundamental GitLab features documentation.
- Reasoning: Clear and accurate documentation of core features like notifications is essential for user adoption and reduces support burden. Fixing known inaccuracies improves user trust and experience.
| Issue | Group(s) | Status | Effort | Priority | Details |
|---|---|---|---|---|---|
| Improve email notification issues documentation | devopsfoundations grouppersonal productivity |
|
Medium | Medium | Target milestone is 17.11. Led by: Marcin |
Implemented MRs:
- Clarify when "due soon" email is sent (gitlab-org/gitlab!187185 - merged)
- Clarify that "Watch" doesn't include all notifi... (gitlab-org/gitlab!187193 - merged)
- Rename notification for being added as approver (gitlab-org/gitlab!187571 - merged)
- Improve Notification settings API doc (gitlab-org/gitlab!187701 - merged)
Theme: Consistent UI text for quick actions and search filters
- Short description: Improve UI text consistency for quick actions and search filters to enhance usability and adhere to style guidelines.
- Reasoning: Consistent terminology and formatting across the GitLab UI reduces cognitive load for users and improves the overall product experience. Addressing inconsistencies in quick actions and search filters ensures these frequently-used features follow the established word list guidance and style standards.
- Note: This work aligns with the UI text responsibilities of the Senior Technical Writer role and supports the broader effort to standardize terminology around work items relationships.
| Issue | Group(s) | Status | Effort | Priority | Details |
|---|---|---|---|---|---|
| Update quick actions to use consistent terminology | groupproject management groupproduct planning |
|
Medium | Medium | Improved phrasing in GitLab quick actions to consistently use "child item" and "parent item" instead of standalone "child" and "parent". Led by: Marcin |
| Standardize search filter labels case and spelling | groupproject management groupproduct planning groupcode review |
|
Medium | Medium | Target milestone is 17.11. Standardizing text labels for search filters to use consistent case and replace hyphens with spaces where appropriate. Two filters improved so far. Led by: Marcin |
Implemented issues and MRs:
- Make work item quick actions text consistent (gitlab-org/gitlab!185087 - merged)
- UI text: filters should have consistent spelling (gitlab-org/gitlab#526006 - closed)
Legend:
-
⏳ : Waiting for<...>.technical writer, orPM input, orEngineering input -
🚧 : In progress -
✅ : Complete -
🏋🏽 : Stretch goal (add next to any item that is aspirational this quarter)
Ongoing tasks
Manage TW-DRI assignments for all milestones:
Specific TW milestone planning issues:
OKR: https://gitlab.com/gitlab-org/technical-writing/team-tasks/-/issues/1266+
- FY26Q1 TW KR1: Add overview summaries to Projec... (gitlab-org/gitlab!181711 - merged) groupproject management
- FY26Q1 TW KR1: Add overview summaries to Knowle... (gitlab-org/gitlab!181713 - merged) groupknowledge
- FY26Q1 TW KR1: Add overview summaries to Produc... (gitlab-org/gitlab!181716 - merged) groupproduct planning
Covering for Lorena in March:
References
Edited by Marcin Sedlak-Jakubowski