Each label that exists in your issue tracker can have its own dedicated list. Select a label below to add a list to your Board and it will automatically be populated with issues that have that label. To create a list for a label that doesn't exist yet, simply create the label below.
Each label that exists in your issue tracker can have its own dedicated
list. Select a label below to add a list to your Board and it will
automatically be populated with issues that have that label. To create
a list for a label that doesn't exist yet, simply create the label below.
-[API](api/README.md) Automate GitLab via a simple and powerful API.
-[CI/CD](ci/README.md) GitLab Continuous Integration (CI) and Continuous Delivery (CD) getting started, `.gitlab-ci.yml` options, and examples.
-[Custom templates for issues and merge requests](customization/issue_and_merge_request_template.md) Pre-fill the description of issues and merge requests to your liking.
-[GitLab as OAuth2 authentication service provider](integration/oauth_provider.md). It allows you to login to other applications from GitLab.
-[Container Registry](container_registry/README.md) Learn how to use GitLab Container Registry.
-[GitLab Basics](gitlab-basics/README.md) Find step by step how to start working on your commandline and on GitLab.
-[GitLab Pages](pages/README.md) Using GitLab Pages.
-[Importing to GitLab](workflow/importing/README.md).
-[Importing and exporting projects between instances](user/project/settings/import_export.md).
-[Koding](user/project/koding.md) Learn how to use Koding, the online IDE.
-[Migrating from SVN](workflow/importing/migrating_from_svn.md) Convert a SVN repository to Git and GitLab.
-[Permissions](user/permissions.md) Learn what each role in a project (external/guest/reporter/developer/master/owner) can do.
...
...
@@ -19,9 +22,6 @@
-[SSH](ssh/README.md) Setup your ssh keys and deploy keys for secure access to your projects.
-[Webhooks](web_hooks/web_hooks.md) Let GitLab notify you when new code has been pushed to your project.
-[Workflow](workflow/README.md) Using GitLab functionality and importing projects from GitHub and SVN.
-[GitLab Pages](pages/README.md) Using GitLab Pages.
-[Custom templates for issues and merge requests](customization/issue_and_merge_request_template.md) Pre-fill the description of issues and merge requests to your liking.
-[Koding](user/project/koding.md) Learn how to use Koding, the online IDE.
If you are you running Ruby 2.1.x, you do not _need_ to upgrade Ruby yet, but you should note that support for 2.1.x is deprecated and we will require 2.3.x in 8.13. It's strongly recommended that you upgrade as soon as possible.
You can check which version you are running with `ruby -v`.
The GitLab Issue Board is a software project management tool used to plan,
organize, and visualize a workflow for a feature or product release.
It can be seen like a light version of a [Kanban] or a [Scrum] board.
Other interesting links:
-[GitLab Issue Board landing page on about.gitlab.com][landing]
-[YouTube video introduction to Issue Boards][youtube]
## Overview
The Issue Board builds on GitLab's existing issue tracking functionality and
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
maintaining the same filtering and sorting abilities you see across the
issue tracker.
Below is a table of the definitions used for GitLab's Issue Board.
| What we call it | What it means |
| -------------- | ------------- |
| **Issue Board** | It represents a different view for your issues. It can have multiple lists with each list consisting of issues represented by cards. |
| **List** | Each label that exists in the issue tracker can have its own dedicated list. Every list is named after the label it is based on and is represented by a column which contains all the issues associated with that label. You can think of a list like the results you get when you filter the issues by a label in your issue tracker. |
| **Card** | Every card represents an issue and it is shown under the list for which it has a label. The information you can see on a card consists of the issue number, the issue title, the assignee and the labels associated with it. You can drag cards around from one list to another. Issues inside lists are [ordered by priority](labels.md#prioritize-labels). |
There are three types of lists, the ones you create based on your labels, and
two default:
-**Backlog** (default): shows all issues that do not fall in one of the other
lists. Always appears on the very left.
-**Done** (default): shows all closed issues. Always appears on the very right.
- Label list: a list based on a label. It shows all issues with that label.
![GitLab Issue Board](img/issue_board.png)
---
In short, here's a list of actions you can take in an Issue Board:
-[Create a new list](#creating-a-new-list).
-[Delete an existing list](#deleting-a-list).
- Drag issues between lists.
- Drag and reorder the lists themselves.
- Change issue labels on-the-fly while dragging issues between lists.
- Close an issue if you drag it to the **Done** list.
- Create a new list from a non-existing label by [creating the label on-the-fly](#creating-a-new-list)
within the Issue Board.
-[Filter issues](#filtering-issues) that appear across your Issue Board.
If you are not able to perform one or more of the things above, make sure you
have the right [permissions](#permissions).
## First time using the Issue Board
The first time you navigate to your Issue Board, you will be presented with the
two default lists (**Backlog** and **Done**) and a welcoming message that gives
you two options. You can either create a predefined set of labels and create
their corresponding lists to the Issue Board or opt-out and use your own lists.