Docs Engineering: Feature prioritization and process
Overview
The Docs Engineering team maintains the GitLab product documentation platform using kanban and milestone-based prioritization. We organize work into themes that balance new capabilities, platform health, and team productivity.
We take inspiration from GitLab’s product principles and product development flow, adapted for our team context.
Issue lifecycle
Create an issue
Anyone can create an issue for the Docs website. Use the bug template for bugs and the default template for anything else. We’ll add labels when triaging, so don’t worry about filling these in correctly.
If you have issues with docs content rather than the website itself, use the “Suggest updates” button at the bottom of the page in question to open an issue in the appropriate project.
Triage process
A Technical Writing staff engineer reviews all new issues 2-3x per week and:
- Applies work type labels
- Adds docs-specific labels for further categorization
- Sets a weight (1/3/8) for effort estimation on features. Weight is used for prioritization, not capacity planning or estimating completion dates.
- Assigns milestone based on priority and capacity.
- Marks as Ready for development when actionable.
Prioritization framework
Priority factors
- Delivering results for customers
- Impact against effort
- Alignment with Technical Writing team roadmap
- Technical dependencies and blocking work
- 60/40 feature/maintenance target per R&D guidelines
Developer workflow
Work selection
Team members self-select from the Ready for development kanban column, balancing feature work, maintenance, and bug fixes. Choose work that fits your available capacity, and don’t hesitate to ask for guidance when needed.
Kanban process
Move issues through Ready for development → In dev → In review → Closed. In general, work is “done” when deployed and documentation is complete.
cbfc7aaa)
