"Organization recipes" - documentation on organizing projects to match team structure and agile process
Problem to solve
Organizations using GitLab would like to be able to have access to simple recipes on how to structure their GitLab projects/groups/permissions to match their teams’ structure.
Existing documentation Projects, Groups
Further details
@gweaver
in https://gitlab.com/gitlab-org/plan/-/issues/200#note_444971172:
The biggest area of feedback I've heard from customers around documentation is that we document the features but not how those they are composed to create a use case / "planning solution." For example, there is no place in the documentation called "Plan" or "Setting up Agile Workflows" ...you get the gist. I find myself on a lot of sales calls spending most of the time just explaining how to use setup GitLab's features to meet the common use cases are sprint planning, workflows, configuring labels for issue types and priority.
It's almost like we need a dedicated section of the docs for Use Cases or something...which more less cross-links to all the relevant feature documentation.
Existing areas to improve:
- iteration docs
- Improve issue boards use cases - especially the Advanced team handover section is unclear. Some other comments about this: #215386 (closed)
Proposal
-
Using Milestones, Iterations, Epics, and Boards together (#6222 (closed)) -
Iteration planning -
Release planning -
Kanban -
SAFe / program management -
Automate (current solution is gitlab-triage
) -
Group/project structure, hierarchies, and inheritance/cascading behavior of plan related functionality
Who can address the issue
Other links/references
Mentioned in https://gitlab.com/gitlab-org/plan/-/issues/200#note_444971172
Content Outline
Get up and running with multi-team planning in GitLab
- The history of agile.
- Effectively organizing your Groups and Projects within GitLab. (#378206 (closed), !101538 (merged))
- Collection of users
- Collection of repos
- Value streams
- Importing work items from another system.
- Setting up workflows and business processes.
- Labels
- Milestones
- Iterations
- Release planning
- Iteration planning
- Creating and managing work items
- Epics
- Issues
- Requirements
- Visibility and reporting
- Milestone / Iteration Reports
- Health status
- Roadmap
- Value Stream Analytics
- Insights
- Practical use cases
- Scrum
- Extreme Programming
- Kanban
- Scaled agile frameworks
- Automating work item management
- gitlab-triage