diff --git a/doc/user/project/issues/due_dates.md b/doc/user/project/issues/due_dates.md new file mode 100644 index 0000000000000000000000000000000000000000..b516d47ffa3503a115c3de8f5c99b975e4f311a3 --- /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. + + + +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. + + + +## 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. + + + +Due dates also appear in your [todos list](../../../workflow/todos.md). + + + +[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 4e6be3cc4317dd2bf415e6e5e2ee3c94b4e0baaf..d259255599dc4dd79b591e6297059a3e6dbeb8e6 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 1af3d04d5072082254d07de2c03e03b4b185a3de..b85de90b4d543472068887c1391f6ac742971999 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 b2edeb6094aa8c0d8f8db60af756a51123dcd1fc..bf2b9428875a32bc15efb68a324903718c34c2cc 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 0000000000000000000000000000000000000000..d2fe1172bab45097974fbb2c8f60442c4da9368d 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 0000000000000000000000000000000000000000..6b37150e7dbe49ed43c1fb8ee08ffd2bed740d12 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 0000000000000000000000000000000000000000..defcd5eca398e89caf1564429c8c1d2701c89679 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 0000000000000000000000000000000000000000..92c9fd4021b87cca207a8274642bfe29546a8115 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 a56ae75fe693f6886f5d9c8e45e3b362317efd4e..0b6f00c6aa447afdf716e56566e83939b4e85528 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)