diff options
Diffstat (limited to 'doc/user/group/planning_hierarchy/index.md')
-rw-r--r-- | doc/user/group/planning_hierarchy/index.md | 67 |
1 files changed, 67 insertions, 0 deletions
diff --git a/doc/user/group/planning_hierarchy/index.md b/doc/user/group/planning_hierarchy/index.md new file mode 100644 index 00000000000..5887328abe4 --- /dev/null +++ b/doc/user/group/planning_hierarchy/index.md @@ -0,0 +1,67 @@ +--- +type: reference +stage: Plan +group: Product Planning +info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments +--- + +# Planning hierarchies **(PREMIUM)** + +Planning hierarchies are an integral part of breaking down your work in GitLab. +To understand how you can use epics and issues together in hierarchies, remember the following: + +- [Epics](../epics/index.md) exist in groups. +- [Issues](../../project/issues/index.md) exist in projects. + +GitLab is not opinionated on how you structure your work and the hierarchy you can build with multi-level +epics. For example, you can use the hierarchy as a folder of issues for bigger initiatives. + +To learn about hierarchies in general, common frameworks, and using GitLab for +portfolio management, see +[How to use GitLab for Agile portfolio planning and project management](https://about.gitlab.com/blog/2020/11/11/gitlab-for-agile-portfolio-planning-project-management/). + +## Hierarchies with epics + +With epics, you can achieve the following hierarchy: + +```mermaid +graph TD + Group_epic --> Project1_Issue1 + Group_epic --> Project1_Issue2 + Group_epic --> Project2_Issue1 +``` + +### Hierarchies with multi-level epics **(ULTIMATE)** + +With the addition of [multi-level epics](../epics/manage_epics.md#multi-level-child-epics) and up to +seven levels of nested epics, you can achieve the following hierarchy: + +<!-- +Image below was generated with the following Mermaid code. +Attached as an image because a rendered diagram doesn't look clear on the docs page. + +```mermaid +classDiagram + direction TD + class Epic + class Issue + + Epic *-- "0..7" Epic +Epic "1"*-- "0..*" Issue +``` + + --> + +![Diagram showing possible relationships of multi-level epics](img/hierarchy_with_multi_level_epics.png) + +## View ancestry of an epic + +In an epic, you can view the ancestors as parents in the right sidebar under **Ancestors**. + +![epics state dropdown](img/epic-view-ancestors-in-sidebar_v14_6.png) + +## View ancestry of an issue + +In an issue, you can view the parented epic above the issue in the right sidebar under **Epic**. + +![epics state dropdown](img/issue-view-parent-epic-in-sidebar_v14_6.png) |