From 8d94a58dcbf2b1dd2716efeb2a5c8987a10d5656 Mon Sep 17 00:00:00 2001 From: Achilleas Pipinellis Date: Tue, 24 Jan 2017 14:59:37 +0100 Subject: Add due dates docs [ci skip] --- doc/user/project/issues/due_dates.md | 37 +++++++++++++++++++++ .../issues/img/confidential_issues_create.png | Bin 9663 -> 9659 bytes .../img/confidential_issues_search_guest.png | Bin 10152 -> 10014 bytes .../img/confidential_issues_search_master.png | Bin 15617 -> 15332 bytes doc/user/project/issues/img/due_dates_create.png | Bin 0 -> 7705 bytes .../project/issues/img/due_dates_edit_sidebar.png | Bin 0 -> 2424 bytes .../issues/img/due_dates_issues_index_page.png | Bin 0 -> 21402 bytes doc/user/project/issues/img/due_dates_todos.png | Bin 0 -> 5644 bytes doc/workflow/README.md | 1 + 9 files changed, 38 insertions(+) create mode 100644 doc/user/project/issues/due_dates.md create mode 100644 doc/user/project/issues/img/due_dates_create.png create mode 100644 doc/user/project/issues/img/due_dates_edit_sidebar.png create mode 100644 doc/user/project/issues/img/due_dates_issues_index_page.png create mode 100644 doc/user/project/issues/img/due_dates_todos.png diff --git a/doc/user/project/issues/due_dates.md b/doc/user/project/issues/due_dates.md new file mode 100644 index 00000000000..b516d47ffa3 --- /dev/null +++ b/doc/user/project/issues/due_dates.md @@ -0,0 +1,37 @@ +# Due dates + +> [Introduced][ce-3614] in GitLab 8.7. + +Due dates can be used in issues to keep track of deadlines and make sure +features are shipped on time. Due dates require at least [Reporter permissions][permissions] +to be able to edit them. On the contrary, they can be seen by everybody. + +## Setting a due date + +When creating or editing an issue, you can see the due date field from where +a calendar will appear to help you choose the date you want. To remove it, +select the date text and delete it. + +![Create a due date](img/due_dates_create.png) + +A quicker way to set a due date is via the issue sidebar. Simply expand the +sidebar and select **Edit** to pick a due date or remove the existing one. +Changes are saved immediately. + +![Edit a due date via the sidebar](img/due_dates_edit_sidebar.png) + +## Making use of due dates + +Issues that have a due date can be distinctively seen in the issues index page +with a calendar icon next to them. Issues where the date is past due will have +the icon and the date colored red. You can sort issues by those that are +_Due soon_ or _Due later_ from the dropdown menu in the right. + +![Issues with due dates in the issues index page](img/due_dates_issues_index_page.png) + +Due dates also appear in your [todos list](../../../workflow/todos.md). + +![Issues with due dates in the todos](img/due_dates_todos.png) + +[ce-3614]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/3614 +[permissions]: ../../permissions.md#project diff --git a/doc/user/project/issues/img/confidential_issues_create.png b/doc/user/project/issues/img/confidential_issues_create.png index 4e6be3cc431..d259255599d 100644 Binary files a/doc/user/project/issues/img/confidential_issues_create.png and b/doc/user/project/issues/img/confidential_issues_create.png differ diff --git a/doc/user/project/issues/img/confidential_issues_search_guest.png b/doc/user/project/issues/img/confidential_issues_search_guest.png index 1af3d04d507..b85de90b4d5 100644 Binary files a/doc/user/project/issues/img/confidential_issues_search_guest.png and b/doc/user/project/issues/img/confidential_issues_search_guest.png differ diff --git a/doc/user/project/issues/img/confidential_issues_search_master.png b/doc/user/project/issues/img/confidential_issues_search_master.png index b2edeb6094a..bf2b9428875 100644 Binary files a/doc/user/project/issues/img/confidential_issues_search_master.png and b/doc/user/project/issues/img/confidential_issues_search_master.png differ diff --git a/doc/user/project/issues/img/due_dates_create.png b/doc/user/project/issues/img/due_dates_create.png new file mode 100644 index 00000000000..d2fe1172bab Binary files /dev/null and b/doc/user/project/issues/img/due_dates_create.png differ diff --git a/doc/user/project/issues/img/due_dates_edit_sidebar.png b/doc/user/project/issues/img/due_dates_edit_sidebar.png new file mode 100644 index 00000000000..6b37150e7db Binary files /dev/null and b/doc/user/project/issues/img/due_dates_edit_sidebar.png differ diff --git a/doc/user/project/issues/img/due_dates_issues_index_page.png b/doc/user/project/issues/img/due_dates_issues_index_page.png new file mode 100644 index 00000000000..defcd5eca39 Binary files /dev/null and b/doc/user/project/issues/img/due_dates_issues_index_page.png differ diff --git a/doc/user/project/issues/img/due_dates_todos.png b/doc/user/project/issues/img/due_dates_todos.png new file mode 100644 index 00000000000..92c9fd4021b Binary files /dev/null and b/doc/user/project/issues/img/due_dates_todos.png differ diff --git a/doc/workflow/README.md b/doc/workflow/README.md index a56ae75fe69..0b6f00c6aa4 100644 --- a/doc/workflow/README.md +++ b/doc/workflow/README.md @@ -10,6 +10,7 @@ - Issues - The GitLab Issue Tracker is an advanced and complete tool for tracking the evolution of a new idea or the process of solving a problem. - [Confidential issues](../user/project/issues/confidential_issues.md) + - [Due date for issues](../user/project/issues/due_dates.md) - [Issue Board](../user/project/issue_board.md) - [Keyboard shortcuts](shortcuts.md) - [File finder](file_finder.md) -- cgit v1.2.1