- Suppose your team is working on a large feature that involves multiple discussions throughout different issues created in distinct projects within a [Group](../index.md). With Epics, you can track all the related activities that together contribute to that single feature.
- Suppose your team is working on a large feature that involves multiple discussions throughout different issues created in distinct projects within a [Group](../index.md). With Epics, you can track all the related activities that together contribute to that single feature.
- Track when the work for the group of issues is targeted to begin, and when it is targeted to end.
- Track when the work for the group of issues is targeted to begin, and when it's targeted to end.
- Discuss and collaborate on feature ideas and scope at a high level.
- Discuss and collaborate on feature ideas and scope at a high level.
![epics list view](img/epics_list_view_v12.5.png)
![epics list view](img/epics_list_view_v12.5.png)
...
@@ -62,7 +62,7 @@ An epic's page contains the following tabs:
...
@@ -62,7 +62,7 @@ An epic's page contains the following tabs:
## Adding an issue to an epic
## Adding an issue to an epic
You can add an existing issue to an epic, or, from an epic's page, create a new issue that is automatically added to the epic.
You can add an existing issue to an epic, or, from an epic's page, create a new issue that's automatically added to the epic.
### Adding an existing issue to an epic
### Adding an existing issue to an epic
...
@@ -70,7 +70,7 @@ Existing issues that belong to a project in an epic's group, or any of the epic'
...
@@ -70,7 +70,7 @@ Existing issues that belong to a project in an epic's group, or any of the epic'
subgroups, are eligible to be added to the epic. Newly added issues appear at the top of the list of issues in the **Epics and Issues** tab.
subgroups, are eligible to be added to the epic. Newly added issues appear at the top of the list of issues in the **Epics and Issues** tab.
An epic contains a list of issues and an issue can be associated with at most
An epic contains a list of issues and an issue can be associated with at most
one epic. When you add an issue that is already linked to an epic,
one epic. When you add an issue that's already linked to an epic,
the issue is automatically unlinked from its current parent.
the issue is automatically unlinked from its current parent.
To add an issue to an epic:
To add an issue to an epic:
...
@@ -101,6 +101,19 @@ To remove an issue from an epic:
...
@@ -101,6 +101,19 @@ To remove an issue from an epic:
1. Click on the <kbd>x</kbd> button in the epic's issue list.
1. Click on the <kbd>x</kbd> button in the epic's issue list.
1. Click **Remove** in the **Remove issue** warning message.
1. Click **Remove** in the **Remove issue** warning message.
## Issue health status in Epic tree **(ULTIMATE)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/199184) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 12.10.
You can report on and quickly respond to the health of individual issues and epics by setting a
red, amber, or green [health status on an issue](../../project/issues/index.md#health-status-ultimate),
which will appear on your Epic tree.
### Disable Issue health status in Epic tree
This feature comes with a feature flag enabled by default. For steps to disable it, see
[Disable issue health status](../../project/issues/index.md#disable-issue-health-status).
## Multi-level child epics **(ULTIMATE)**
## Multi-level child epics **(ULTIMATE)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/8333) in GitLab Ultimate 11.7.
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/8333) in GitLab Ultimate 11.7.
...
@@ -108,7 +121,7 @@ To remove an issue from an epic:
...
@@ -108,7 +121,7 @@ To remove an issue from an epic:
Any epic that belongs to a group, or subgroup of the parent epic's group, is
Any epic that belongs to a group, or subgroup of the parent epic's group, is
eligible to be added. New child epics appear at the top of the list of epics in the **Epics and Issues** tab.
eligible to be added. New child epics appear at the top of the list of epics in the **Epics and Issues** tab.
When you add an epic that is already linked to a parent epic, the link to its current parent is removed.
When you add an epic that's already linked to a parent epic, the link to its current parent is removed.
<li>Status (On track, Needs attention, or At risk)</li>
<li>Health status (on track, needs attention, or at risk)</li>
<li>Confidentiality</li>
<li>Confidentiality</li>
<li>Tasks (completed vs. outstanding)</li>
<li>Tasks (completed vs. outstanding)</li>
</ul>
</ul>
...
@@ -166,11 +166,12 @@ requires [GraphQL](../../../api/graphql/index.md) to be enabled.
...
@@ -166,11 +166,12 @@ requires [GraphQL](../../../api/graphql/index.md) to be enabled.
---
---
### Status **(ULTIMATE)**
### Health status **(ULTIMATE)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/36427) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 12.10.
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/36427) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 12.10.
To help you track the status of your issues, you can assign a status to each issue to flag work that's progressing as planned or needs attention to keep on schedule:
To help you track the status of your issues, you can assign a status to each issue to flag work
that's progressing as planned or needs attention to keep on schedule:
-**On track** (green)
-**On track** (green)
-**Needs attention** (amber)
-**Needs attention** (amber)
...
@@ -178,9 +179,10 @@ To help you track the status of your issues, you can assign a status to each iss
...
@@ -178,9 +179,10 @@ To help you track the status of your issues, you can assign a status to each iss
!["On track" health status on an issue](img/issue_health_status_v12_10.png)
!["On track" health status on an issue](img/issue_health_status_v12_10.png)
ProjectTemplate.new('nfgitbook','Netlify/GitBook',_('A GitBook site that uses Netlify for CI/CD instead of GitLab, but still with all the other great GitLab features.'),'https://gitlab.com/pages/nfgitbook','illustrations/logos/netlify.svg'),
ProjectTemplate.new('nfgitbook','Netlify/GitBook',_('A GitBook site that uses Netlify for CI/CD instead of GitLab, but still with all the other great GitLab features.'),'https://gitlab.com/pages/nfgitbook','illustrations/logos/netlify.svg'),
ProjectTemplate.new('nfhexo','Netlify/Hexo',_('A Hexo site that uses Netlify for CI/CD instead of GitLab, but still with all the other great GitLab features.'),'https://gitlab.com/pages/nfhexo','illustrations/logos/netlify.svg'),
ProjectTemplate.new('nfhexo','Netlify/Hexo',_('A Hexo site that uses Netlify for CI/CD instead of GitLab, but still with all the other great GitLab features.'),'https://gitlab.com/pages/nfhexo','illustrations/logos/netlify.svg'),
ProjectTemplate.new('salesforcedx','SalesforceDX',_('A project boilerplate for Salesforce App development with Salesforce Developer tools.'),'https://gitlab.com/gitlab-org/project-templates/salesforcedx'),
ProjectTemplate.new('salesforcedx','SalesforceDX',_('A project boilerplate for Salesforce App development with Salesforce Developer tools.'),'https://gitlab.com/gitlab-org/project-templates/salesforcedx'),
ProjectTemplate.new('serverless_framework','Serverless Framework/JS',_('A basic page and serverless function that uses AWS Lambda, AWS API Gateway, and GitLab Pages'),'https://gitlab.com/gitlab-org/project-templates/serverless-framework','illustrations/logos/serverless_framework.svg')
ProjectTemplate.new('serverless_framework','Serverless Framework/JS',_('A basic page and serverless function that uses AWS Lambda, AWS API Gateway, and GitLab Pages'),'https://gitlab.com/gitlab-org/project-templates/serverless-framework','illustrations/logos/serverless_framework.svg'),
ProjectTemplate.new('cluster_management','GitLab Cluster Management',_('An example project for managing Kubernetes clusters integrated with GitLab.'),'https://gitlab.com/gitlab-org/project-templates/cluster-management')
msgid "You didn't renew your %{strong}%{plan_name}%{strong_close} subscription for %{strong}%{namespace_name}%{strong_close} so it was downgraded to the free plan."
msgstr ""
msgid "You didn't renew your %{strong}%{plan_name}%{strong_close} subscription so it was downgraded to the GitLab Core Plan."
msgid "You didn't renew your %{strong}%{plan_name}%{strong_close} subscription so it was downgraded to the GitLab Core Plan."
msgstr ""
msgstr ""
...
@@ -23637,6 +23646,9 @@ msgstr ""
...
@@ -23637,6 +23646,9 @@ msgstr ""
msgid "YouTube"
msgid "YouTube"
msgstr ""
msgstr ""
msgid "Your %{strong}%{plan_name}%{strong_close} subscription for %{strong}%{namespace_name}%{strong_close} will expire on %{strong}%{expires_on}%{strong_close}. After that, you will not to be able to create issues or merge requests as well as many other features."
msgstr ""
msgid "Your %{strong}%{plan_name}%{strong_close} subscription will expire on %{strong}%{expires_on}%{strong_close}. After that, you will not to be able to create issues or merge requests as well as many other features."
msgid "Your %{strong}%{plan_name}%{strong_close} subscription will expire on %{strong}%{expires_on}%{strong_close}. After that, you will not to be able to create issues or merge requests as well as many other features."
msgstr ""
msgstr ""
...
@@ -23861,6 +23873,9 @@ msgstr ""
...
@@ -23861,6 +23873,9 @@ msgstr ""
msgid "assign yourself"
msgid "assign yourself"
msgstr ""
msgstr ""
msgid "at risk"
msgstr ""
msgid "attach a new file"
msgid "attach a new file"
msgstr ""
msgstr ""
...
@@ -24364,6 +24379,15 @@ msgstr ""
...
@@ -24364,6 +24379,15 @@ msgstr ""
msgid "issue"
msgid "issue"
msgstr ""
msgstr ""
msgid "issues at risk"
msgstr ""
msgid "issues need attention"
msgstr ""
msgid "issues on track"
msgstr ""
msgid "it is stored externally"
msgid "it is stored externally"
msgstr ""
msgstr ""
...
@@ -24744,6 +24768,9 @@ msgstr ""
...
@@ -24744,6 +24768,9 @@ msgstr ""
msgid "n/a"
msgid "n/a"
msgstr ""
msgstr ""
msgid "need attention"
msgstr ""
msgid "needs to be between 10 minutes and 1 month"
msgid "needs to be between 10 minutes and 1 month"
@@ -25,7 +25,8 @@ describe Gitlab::ProjectTemplate do
...
@@ -25,7 +25,8 @@ describe Gitlab::ProjectTemplate do
described_class.new('nfgitbook','Netlify/GitBook',_('A GitBook site that uses Netlify for CI/CD instead of GitLab, but still with all the other great GitLab features.'),'https://gitlab.com/pages/nfgitbook'),
described_class.new('nfgitbook','Netlify/GitBook',_('A GitBook site that uses Netlify for CI/CD instead of GitLab, but still with all the other great GitLab features.'),'https://gitlab.com/pages/nfgitbook'),
described_class.new('nfhexo','Netlify/Hexo',_('A Hexo site that uses Netlify for CI/CD instead of GitLab, but still with all the other great GitLab features.'),'https://gitlab.com/pages/nfhexo'),
described_class.new('nfhexo','Netlify/Hexo',_('A Hexo site that uses Netlify for CI/CD instead of GitLab, but still with all the other great GitLab features.'),'https://gitlab.com/pages/nfhexo'),
described_class.new('salesforcedx','SalesforceDX',_('A project boilerplate for Salesforce App development with Salesforce Developer tools.'),'https://gitlab.com/gitlab-org/project-templates/salesforcedx'),
described_class.new('salesforcedx','SalesforceDX',_('A project boilerplate for Salesforce App development with Salesforce Developer tools.'),'https://gitlab.com/gitlab-org/project-templates/salesforcedx'),
described_class.new('serverless_framework','Serverless Framework/JS',_('A basic page and serverless function that uses AWS Lambda, AWS API Gateway, and GitLab Pages'),'https://gitlab.com/gitlab-org/project-templates/serverless-framework','illustrations/logos/serverless_framework.svg')
described_class.new('serverless_framework','Serverless Framework/JS',_('A basic page and serverless function that uses AWS Lambda, AWS API Gateway, and GitLab Pages'),'https://gitlab.com/gitlab-org/project-templates/serverless-framework','illustrations/logos/serverless_framework.svg'),
described_class.new('cluster_management','GitLab Cluster Management',_('An example project for managing Kubernetes clusters integrated with GitLab.'),'https://gitlab.com/gitlab-org/project-templates/cluster-management')