2016-06-21 20:55:36 +00:00
|
|
|
# GitLab Todos
|
2016-03-02 12:33:47 +00:00
|
|
|
|
|
|
|
>**Note:** This feature was [introduced][ce-2817] in GitLab 8.5.
|
|
|
|
|
|
|
|
When you log into GitLab, you normally want to see where you should spend your
|
|
|
|
time and take some action, or what you need to keep an eye on. All without the
|
|
|
|
mess of a huge pile of e-mail notifications. GitLab is where you do your work,
|
|
|
|
so being able to get started quickly is very important.
|
|
|
|
|
|
|
|
Todos is a chronological list of to-dos that are waiting for your input, all
|
|
|
|
in a simple dashboard.
|
|
|
|
|
|
|
|
![Todos screenshot showing a list of items to check on](img/todos_index.png)
|
|
|
|
|
|
|
|
---
|
|
|
|
|
2016-06-21 20:55:36 +00:00
|
|
|
You can quickly access the Todos dashboard using the bell icon next to the
|
|
|
|
search bar in the upper right corner. The number in blue is the number of Todos
|
|
|
|
you still have open.
|
2016-03-02 12:33:47 +00:00
|
|
|
|
|
|
|
![Todos icon](img/todos_icon.png)
|
|
|
|
|
|
|
|
## What triggers a Todo
|
|
|
|
|
|
|
|
A Todo appears in your Todos dashboard when:
|
|
|
|
|
|
|
|
- an issue or merge request is assigned to you
|
|
|
|
- you are `@mentioned` in an issue or merge request, be it the description of
|
|
|
|
the issue/merge request or in a comment
|
|
|
|
|
|
|
|
>**Note:** Commenting on a commit will _not_ trigger a Todo.
|
|
|
|
|
2016-06-21 20:55:36 +00:00
|
|
|
### Manually creating a Todo
|
|
|
|
|
|
|
|
You can also add an issue or merge request to your Todos dashboard by clicking
|
|
|
|
the "Add Todo" button in the issue or merge request sidebar.
|
|
|
|
|
|
|
|
![Adding a Todo from the issuable sidebar](img/todos_add_todo_sidebar.png)
|
|
|
|
|
|
|
|
## Marking a Todo as done
|
2016-03-02 12:33:47 +00:00
|
|
|
|
|
|
|
Any action to the corresponding issue or merge request will mark your Todo as
|
2016-06-21 20:55:36 +00:00
|
|
|
**Done**. Actions that dismiss Todos include:
|
2016-03-02 12:33:47 +00:00
|
|
|
|
|
|
|
- changing the assignee
|
|
|
|
- changing the milestone
|
|
|
|
- adding/removing a label
|
|
|
|
- commenting on the issue
|
|
|
|
|
|
|
|
---
|
|
|
|
|
2016-06-21 20:55:36 +00:00
|
|
|
Todos are personal, and they're only marked as done if the action is coming from
|
|
|
|
you. If you close the issue or merge request, your Todo will automatically
|
|
|
|
be marked as done.
|
|
|
|
|
|
|
|
If someone else closes, merges, or takes action on the issue or merge
|
2016-06-22 14:49:40 +00:00
|
|
|
request, your Todo will remain pending. This prevents other users from closing issues without you being notified.
|
2016-03-02 12:33:47 +00:00
|
|
|
|
|
|
|
There is just one Todo per issue or merge request, so mentioning a user a
|
|
|
|
hundred times in an issue will only trigger one Todo.
|
|
|
|
|
2016-06-21 20:55:36 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
If no action is needed, you can manually mark the Todo as done by clicking the
|
|
|
|
corresponding **Done** button, and it will disappear from your Todo list.
|
|
|
|
|
|
|
|
![A Todo in the Todos dashboard](img/todo_list_item.png)
|
|
|
|
|
|
|
|
A Todo can also be marked as done from the issue or merge request sidebar using
|
|
|
|
the "Mark Done" button.
|
|
|
|
|
|
|
|
![Mark Done from the issuable sidebar](img/todos_mark_done_sidebar.png)
|
|
|
|
|
|
|
|
You can mark all your Todos as done at once by clicking on the **Mark all as
|
|
|
|
done** button.
|
|
|
|
|
2016-03-02 12:33:47 +00:00
|
|
|
## Filtering your Todos
|
|
|
|
|
2016-06-21 20:55:36 +00:00
|
|
|
There are four kinds of filters you can use on your Todos dashboard.
|
2016-03-02 12:33:47 +00:00
|
|
|
|
2016-06-21 20:55:36 +00:00
|
|
|
| Filter | Description |
|
|
|
|
| ------- | ----------- |
|
2016-03-02 12:33:47 +00:00
|
|
|
| Project | Filter by project |
|
|
|
|
| Author | Filter by the author that triggered the Todo |
|
|
|
|
| Type | Filter by issue or merge request |
|
|
|
|
| Action | Filter by the action that triggered the Todo (Assigned or Mentioned)|
|
|
|
|
|
2016-06-21 20:55:36 +00:00
|
|
|
You can also filter by more than one of these at the same time.
|
2016-03-02 12:33:47 +00:00
|
|
|
|
|
|
|
[ce-2817]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2817
|