Commit 982d95e0 authored by Marcin Sedlak-Jakubowski's avatar Marcin Sedlak-Jakubowski

Merge branch 'docs-issue-concept-update' into 'master'

Update Issue page for clarity

See merge request gitlab-org/gitlab!52335
parents 141a85ac aabcaffd
--- ---
redirect_to: '../user/project/issues/index.md#viewing-and-managing-issues' redirect_to: '../user/project/issues/index.md#view-and-manage-issues'
--- ---
This document was moved to [another location](../user/project/issues/index.md#viewing-and-managing-issues). This document was moved to [another location](../user/project/issues/index.md#view-and-manage-issues).
<!-- This redirect file can be deleted after February 1, 2021. --> <!-- This redirect file can be deleted after February 1, 2021. -->
<!-- Before deletion, see: https://docs.gitlab.com/ee/development/documentation/#move-or-rename-a-page --> <!-- Before deletion, see: https://docs.gitlab.com/ee/development/documentation/#move-or-rename-a-page -->
...@@ -43,7 +43,7 @@ GitLab is a Git-based platform that integrates a great number of essential tools ...@@ -43,7 +43,7 @@ GitLab is a Git-based platform that integrates a great number of essential tools
- Hosting code in repositories with version control. - Hosting code in repositories with version control.
- Tracking proposals for new implementations, bug reports, and feedback with a - Tracking proposals for new implementations, bug reports, and feedback with a
fully featured [Issue Tracker](project/issues/index.md#issues-list). fully featured [Issue Tracker](project/issues/index.md#issues-list).
- Organizing and prioritizing with [Issue Boards](project/issues/index.md#issue-boards). - Organizing and prioritizing with [Issue Boards](project/issue_board.md).
- Reviewing code in [Merge Requests](project/merge_requests/index.md) with live-preview changes per - Reviewing code in [Merge Requests](project/merge_requests/index.md) with live-preview changes per
branch with [Review Apps](../ci/review_apps/index.md). branch with [Review Apps](../ci/review_apps/index.md).
- Building, testing, and deploying with built-in [Continuous Integration](../ci/README.md). - Building, testing, and deploying with built-in [Continuous Integration](../ci/README.md).
......
...@@ -6,33 +6,27 @@ info: To determine the technical writer assigned to the Stage/Group associated w ...@@ -6,33 +6,27 @@ info: To determine the technical writer assigned to the Stage/Group associated w
# Issues **(CORE)** # Issues **(CORE)**
Issues are the fundamental medium for collaborating on ideas and planning work in GitLab. Issues are the fundamental mechanism in GitLab to collaborate on ideas, solve
problems, and plan work.
## Overview Using issues, you can share and discuss proposals (both before and during their
implementation) between you and your team, and outside collaborators.
The GitLab issue tracker is an advanced tool for collaboratively developing ideas, solving problems, You can use issues for many purposes, customized to your needs and workflow.
and planning work. Common use cases include:
Issues can allow sharing and discussion of proposals before, and during, - Discussing the implementation of a new idea.
their implementation between: - Tracking tasks and work status.
- Accepting feature proposals, questions, support requests, or bug reports.
- Elaborating on new code implementations.
- You and your team. For more information about using issues, see the
- Outside collaborators. [Always start a discussion with an issue](https://about.gitlab.com/blog/2016/03/03/start-with-an-issue/)
GitLab blog post.
They can also be used for a variety of other purposes, customized to your Issues are always associated with a specific project. If you have multiple
needs and workflow. projects in a group, you can view all of the issues collectively at the group
level.
Issues are always associated with a specific project. If you have multiple projects in a group,
you can view all of the issues collectively at the group level.
**Common use cases include:**
- Discussing the implementation of a new idea
- Tracking tasks and work status
- Accepting feature proposals, questions, support requests, or bug reports
- Elaborating on new code implementations
See also [Always start a discussion with an issue](https://about.gitlab.com/blog/2016/03/03/start-with-an-issue/).
<i class="fa fa-youtube-play youtube" aria-hidden="true"></i> <i class="fa fa-youtube-play youtube" aria-hidden="true"></i>
To learn how our Strategic Marketing department uses GitLab issues with [labels](../labels.md) and To learn how our Strategic Marketing department uses GitLab issues with [labels](../labels.md) and
...@@ -41,63 +35,30 @@ To learn how our Strategic Marketing department uses GitLab issues with [labels] ...@@ -41,63 +35,30 @@ To learn how our Strategic Marketing department uses GitLab issues with [labels]
## Parts of an issue ## Parts of an issue
Issues contain a variety of content and metadata, enabling a large range of flexibility Issues have a flexible content and metadata structure. Here are some of the
in how they are used. Each issue can contain the following attributes, though not all items elements you can provide in an issue:
must be set.
- Title
<table class="borderless-table fixed-table"> - Description and tasks
<tr> - Comments and other activity
<td> - Author
<ul> - Assignees
<li>Content</li> - State (open or closed)
<ul> - Health status (on track, needs attention, or at risk)
<li>Title</li> - Confidentiality
<li>Description and tasks</li> - Tasks (completed vs. outstanding)
<li>Comments and other activity</li> - Milestone
</ul> - Due date
<li>People</li> - Weight
<ul> - Time tracking
<li>Author</li> - Labels
<li>Assignee(s)</li> - Votes
</ul> - Reaction emoji
<li>State</li> - Linked issues
<ul> - Assigned epic
<li>State (open or closed)</li> - Unique issue number and URL
<li>Health status (on track, needs attention, or at risk)</li>
<li>Confidentiality</li> ## View and manage issues
<li>Tasks (completed vs. outstanding)</li>
</ul>
</ul>
</td>
<td>
<ul>
<li>Planning and tracking</li>
<ul>
<li>Milestone</li>
<li>Due date</li>
<li>Weight</li>
<li>Time tracking</li>
<li>Labels</li>
<li>Votes</li>
<li>Reaction emoji</li>
<li>Linked issues</li>
<li>Assigned epic</li>
<li>Unique issue number and URL</li>
</ul>
</ul>
</td>
</tr>
</table>
## Viewing and managing issues
While you can view and manage details of an issue on the [issue page](#issue-page),
you can also work with multiple issues at a time using:
- [Issues List](#issues-list).
- [Issue Boards](#issue-boards).
- Issue references.
- [Epics](#epics) **(PREMIUM)**.
Key actions for issues include: Key actions for issues include:
...@@ -105,7 +66,17 @@ Key actions for issues include: ...@@ -105,7 +66,17 @@ Key actions for issues include:
- [Moving issues](managing_issues.md#moving-issues) - [Moving issues](managing_issues.md#moving-issues)
- [Closing issues](managing_issues.md#closing-issues) - [Closing issues](managing_issues.md#closing-issues)
- [Deleting issues](managing_issues.md#deleting-issues) - [Deleting issues](managing_issues.md#deleting-issues)
- [Promoting issues](managing_issues.md#promote-an-issue-to-an-epic) **(PREMIUM)** - [Promoting issues](managing_issues.md#promote-an-issue-to-an-epic)
Although you can view and manage details of an issue on the [issue page](#issue-page),
you can also work with several issues at a time by using these features:
- [Issues List](#issues-list): View a list of issues in a project or group.
- [Issue Boards](../issue_board.md): Organize issues with a project management
workflow for a feature or product release.
- Issue references
- [Epics](../../group/epics/index.md): Manage your portfolio of projects by
tracking groups of issues with a shared theme.
### Issue page ### Issue page
...@@ -125,7 +96,7 @@ To enable it, you need to enable [ActionCable in-app mode](https://docs.gitlab.c ...@@ -125,7 +96,7 @@ To enable it, you need to enable [ActionCable in-app mode](https://docs.gitlab.c
![Project Issues List view](img/project_issues_list_view.png) ![Project Issues List view](img/project_issues_list_view.png)
On the Issues List, you can: In the Issues List, you can:
- View all issues in a project when opening the Issues List from a project context. - View all issues in a project when opening the Issues List from a project context.
- View all issues in a groups's projects when opening the Issues List from a group context. - View all issues in a groups's projects when opening the Issues List from a group context.
...@@ -154,31 +125,12 @@ This feature might not be available to you. Check the **version history** note a ...@@ -154,31 +125,12 @@ This feature might not be available to you. Check the **version history** note a
In a group, the sidebar displays the total count of open issues and this value is cached if higher In a group, the sidebar displays the total count of open issues and this value is cached if higher
than 1000. The cached value is rounded to thousands (or millions) and updated every 24 hours. than 1000. The cached value is rounded to thousands (or millions) and updated every 24 hours.
### Issue boards
![Issue board](img/issue_board.png)
[Issue boards](../issue_board.md) are Kanban boards with columns that display issues based on their
labels or their assignees**(PREMIUM)**. They offer the flexibility to manage issues using
highly customizable workflows.
You can reorder issues in the column. If you drag an issue card to another column, its
associated label or assignee is changed to match that of the new column. The entire
board can also be filtered to only include issues from a certain milestone or an overarching
label.
### Design Management ### Design Management
With [Design Management](design_management.md), you can upload design With [Design Management](design_management.md), you can upload design
assets to issues and view them all together for sharing and assets to issues and view them all together for sharing and
collaboration with your team. collaboration with your team.
### Epics **(PREMIUM)**
[Epics](../../group/epics/index.md) let you manage your portfolio of projects more
efficiently and with less effort. Epics track groups of issues that share a theme, across
projects and milestones.
### Related issues ### Related issues
You can mark two issues as related, so that when viewing one, the other is always You can mark two issues as related, so that when viewing one, the other is always
......
...@@ -129,7 +129,7 @@ element. Due dates can be changed as many times as needed. ...@@ -129,7 +129,7 @@ element. Due dates can be changed as many times as needed.
### Labels ### Labels
Categorize issues by giving them [labels](../labels.md). They help to organize workflows, Categorize issues by giving them [labels](../labels.md). They help to organize workflows,
and they enable you to work with the [GitLab Issue Board](index.md#issue-boards). and they enable you to work with the [GitLab Issue Board](../issue_board.md).
Group Labels, which allow you to use the same labels for all projects in the same Group Labels, which allow you to use the same labels for all projects in the same
group, can also be given to issues. They work exactly the same, but are immediately group, can also be given to issues. They work exactly the same, but are immediately
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment