Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
e897dfeb
Commit
e897dfeb
authored
Jul 03, 2017
by
Achilleas Pipinellis
Browse files
Options
Browse Files
Download
Plain Diff
Merge branch 'docs/overview-features-2' into 'master'
Add overview and use-cases to Issue Boards doc See merge request !12543
parents
68ac3914
f75ee481
Changes
3
Hide whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
62 additions
and
10 deletions
+62
-10
doc/user/project/img/issue_board_move_issue_card_list.png
doc/user/project/img/issue_board_move_issue_card_list.png
+0
-0
doc/user/project/issue_board.md
doc/user/project/issue_board.md
+61
-9
doc/user/project/issues/index.md
doc/user/project/issues/index.md
+1
-1
No files found.
doc/user/project/img/issue_board_move_issue_card_list.png
0 → 100644
View file @
e897dfeb
73.1 KB
doc/user/project/issue_board.md
View file @
e897dfeb
# Issue
b
oard
# Issue
B
oard
>**Notes:**
>**Note:**
-
[
Introduced
][
ce-5554
]
in GitLab 8.11.
[
Introduced
][
ce-5554
]
in
[
GitLab 8.11
](
https://about.gitlab.com/2016/08/22/gitlab-8-11-released/#issue-board
)
.
-
The Backlog column was replaced by the
**Add issues**
button in GitLab 8.17.
The GitLab Issue Board is a software project management tool used to plan,
The GitLab Issue Board is a software project management tool used to plan,
organize, and visualize a workflow for a feature or product release.
organize, and visualize a workflow for a feature or product release.
...
@@ -15,12 +14,65 @@ Other interesting links:
...
@@ -15,12 +14,65 @@ Other interesting links:
## Overview
## Overview
The Issue Board builds on GitLab's existing issue tracking functionality and
The Issue Board builds on GitLab's existing
[
issue tracking functionality
](
issues/index.md#issue-tracker
)
and
leverages the power of [labels] by utilizing them as lists of the scrum board.
leverages the power of [labels] by utilizing them as lists of the scrum board.
With the Issue Board you can have a different view of your issues while
also
With the Issue Board you can have a different view of your issues while
maintaining the same filtering and sorting abilities you see across the
maintaining the same filtering and sorting abilities you see across the
issue tracker.
issue tracker. An Issue Board is based on its project's label structure, therefore, it
applies the same descriptive labels to indicate placement on the board, keeping
consistency throughout the entire development lifecycle.
An Issue Board shows you what issues your team is working on, who is assigned to each,
and where in the workflow those issues are.
You create issues, host code, perform reviews, build, test,
and deploy from one single platform. Issue Boards help you to visualize
and manage the entire process _in_ GitLab.
With
[
Multiple Issue Boards
](
https://docs.gitlab.com/ee/user/project/issue_board.html#multiple-issue-boards
)
, available
only in
[
GitLab Enterprise Edition
](
https://about.gitlab.com/gitlab-ee/
)
,
you go even further, as you can not only keep yourself and your project
organized from a broader perspective with one Issue Board per project,
but also allow your team members to organize their own workflow by creating
multiple Issue Boards within the same project.
## Use cases
GitLab Workflow allows you to discuss proposals in issues, categorize them
with labels, and from there organize and prioritize them with Issue Boards.
For example, let's consider this simplified development workflow:
1.
You have a repository hosting your app's codebase
and your team actively contributing to code
1.
Your
**backend**
team starts working a new
implementation, gathers feedback and approval, and pass it over to
**frontend**
1.
When frontend is complete, the new feature is deployed to
**staging**
to be tested
1.
When successful, it is deployed to
**production**
If we have the labels "
**backend**
", "
**frontend**
", "
**staging**
", and
"
**production**
", and an Issue Board with a list for each, we can:
-
Visualize the entire flow of implementations since the
beginning of the development lifecycle until deployed to production
-
Prioritize the issues in a list by moving them vertically
-
Move issues between lists to organize them according to the labels you've set
-
Add multiple issues to lists in the board by selecting one or more existing issues
![
issue card moving
](
img/issue_board_move_issue_card_list.png
)
> **Notes:**
>
>- For a broader use case, please check the blog post
[
GitLab Workflow, an Overview
](
https://about.gitlab.com/2016/10/25/gitlab-workflow-an-overview/#gitlab-workflow-use-case-scenario
)
.
>
>- For a real use case, please check why
[
Codepen decided to adopt Issue Boards
](
https://about.gitlab.com/2017/01/27/codepen-welcome-to-gitlab/#project-management-everything-in-one-place
)
to improve their workflow with
[
multiple boards
](
https://docs.gitlab.com/ee/user/project/issue_board.html#multiple-issue-boards
)
.
## Issue Board terminology
Below is a table of the definitions used for GitLab's Issue Board.
Below is a table of the definitions used for GitLab's Issue Board.
...
@@ -57,7 +109,7 @@ In short, here's a list of actions you can take in an Issue Board:
...
@@ -57,7 +109,7 @@ In short, here's a list of actions you can take in an Issue Board:
If you are not able to perform one or more of the things above, make sure you
If you are not able to perform one or more of the things above, make sure you
have the right
[
permissions
](
#permissions
)
.
have the right
[
permissions
](
#permissions
)
.
## First time using the
issue b
oard
## First time using the
Issue B
oard
The first time you navigate to your Issue Board, you will be presented with
The first time you navigate to your Issue Board, you will be presented with
a default list (
**Done**
) and a welcoming message that gives
a default list (
**Done**
) and a welcoming message that gives
...
@@ -98,7 +150,7 @@ list view that is removed. You can always add it back later if you need.
...
@@ -98,7 +150,7 @@ list view that is removed. You can always add it back later if you need.
## Adding issues to a list
## Adding issues to a list
You can add issues to a list by clicking the
**Add issues**
button that is
You can add issues to a list by clicking the
**Add issues**
button that is
present in the upper right corner of the
issue b
oard. This will open up a modal
present in the upper right corner of the
Issue B
oard. This will open up a modal
window where you can see all the issues that do not belong to any list.
window where you can see all the issues that do not belong to any list.
Select one or more issues by clicking on the cards and then click
**Add issues**
Select one or more issues by clicking on the cards and then click
**Add issues**
...
...
doc/user/project/issues/index.md
View file @
e897dfeb
# Issues
documentation
# Issues
The GitLab Issue Tracker is an advanced and complete tool
The GitLab Issue Tracker is an advanced and complete tool
for tracking the evolution of a new idea or the process
for tracking the evolution of a new idea or the process
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment