From 19d061db714252976b2ef53f5df2813c396b401a Mon Sep 17 00:00:00 2001 From: Frederic Guillot Date: Sat, 21 Feb 2015 21:05:56 -0500 Subject: Update documentation --- docs/board-configuration.markdown | 17 +++++++++++++++++ docs/calendar.markdown | 14 ++++++++++++++ docs/keyboard-shortcuts.markdown | 15 +++++++++++++++ docs/link-labels.markdown | 11 +++++++++++ docs/task-links.markdown | 22 ++++++++++++++++++++++ docs/time-tracking.markdown | 38 ++++++++++++++++++++++++++++++++++++++ 6 files changed, 117 insertions(+) create mode 100644 docs/calendar.markdown create mode 100644 docs/keyboard-shortcuts.markdown create mode 100644 docs/link-labels.markdown create mode 100644 docs/task-links.markdown create mode 100644 docs/time-tracking.markdown (limited to 'docs') diff --git a/docs/board-configuration.markdown b/docs/board-configuration.markdown index 174618c2..f381ebf9 100644 --- a/docs/board-configuration.markdown +++ b/docs/board-configuration.markdown @@ -41,3 +41,20 @@ Categories are not global to the application but attached to a project. Each project can have different categories. However, if you always create the same categories for all your projects, you can define here the list of categories to create automatically. + +### Allow only one subtask in progress at the same time for a user + +When this option is enabled, a user can work with only one subtask at the time. + +If another subtask have the status "in progress", the user will see this dialog box: + +![Subtask user restriction](http://kanboard.net/screenshots/documentation/subtask-user-restriction.png) + +### Enable time tracking for subtasks + +When this option is enabled, each time the status of a subtask is changed, the start time and the end time are recorded in the database for the assignee. + +- When the status changes to "in progress" then the start time is saved +- When the status changes to "done" then the end time is saved + +The time spent for the subtask and the task is also updated. diff --git a/docs/calendar.markdown b/docs/calendar.markdown new file mode 100644 index 00000000..7b5be5fb --- /dev/null +++ b/docs/calendar.markdown @@ -0,0 +1,14 @@ +Calendar +======== + +There are two different views for the calendar: + +- The project view with filters (available from the board) +- The user view (available from the dashboard and from the user section) + +At this time the calendar is able to display these information: + +- Tasks with a due date, displayed at the top. The date can be changed by moving the task to another day. +- Subtask time tracking, each recorded time slot will be shown in the calendar. + +![Calendar](http://kanboard.net/screenshots/documentation/calendar.png) diff --git a/docs/keyboard-shortcuts.markdown b/docs/keyboard-shortcuts.markdown new file mode 100644 index 00000000..a11caccc --- /dev/null +++ b/docs/keyboard-shortcuts.markdown @@ -0,0 +1,15 @@ +Keyboard shortcuts +================== + +Board view +---------- + +- New task = **n** +- Expand/collapse tasks = **s** + +Application +----------- + +- Open board switcher = **b** +- Close dialog box = **ESC** +- Submit a form = **CTRL+ENTER** or **⌘+ENTER** diff --git a/docs/link-labels.markdown b/docs/link-labels.markdown new file mode 100644 index 00000000..e6423566 --- /dev/null +++ b/docs/link-labels.markdown @@ -0,0 +1,11 @@ +Link settings +============= + +Task relations can be changed from the application settings (**Settings > Link settings**) + +![Link Labels](http://kanboard.net/screenshots/documentation/link-labels.png) + +Each label may have an opposite label defined. +If there is no opposite, the label is considered bi-directionnal. + +![Link Label Creation](http://kanboard.net/screenshots/documentation/link-label-creation.png) diff --git a/docs/task-links.markdown b/docs/task-links.markdown new file mode 100644 index 00000000..1eab51fd --- /dev/null +++ b/docs/task-links.markdown @@ -0,0 +1,22 @@ +Task Links +========== + +Tasks can be linked together with predefined relationships: + +![Task Links](http://kanboard.net/screenshots/documentation/task-links.png) + +The default relationships are: + +- **relates to** +- **blocks** | is blocked by +- **is blocked by** | blocks +- **duplicates** | is duplicated by +- **is duplicated by** | duplicates +- **is a child of** | is a parent of +- **is a parent of** | is a child of +- **targets milestone** | is a milestone of +- **is a milestone of** | targets milestone +- **fixes** | is fixed by +- **is fixed by** | fixes + +Those labels can be changed in the application settings. diff --git a/docs/time-tracking.markdown b/docs/time-tracking.markdown new file mode 100644 index 00000000..575a0094 --- /dev/null +++ b/docs/time-tracking.markdown @@ -0,0 +1,38 @@ +Time Tracking +============= + +Time tracking information can be defined at the task level or at the subtask level. + +Task time tracking +------------------ + +![Task time tracking](http://kanboard.net/screenshots/documentation/task-time-tracking.png) + +Tasks have two fields: + +- Time estimated +- Time spent + +These values represents hours of work and have to be set manually. + +Subtask time tracking +--------------------- + +![Subtask time tracking](http://kanboard.net/screenshots/documentation/subtask-time-tracking.png) + +Subtasks also have the fields "time spent" and "time estimated". +However, when you set a value for those fields, **the task time tracking values becomes the sum of all subtask values**. + +User time tracking +------------------ + +In the board settings, you can enable subtasks time tracking for users. + +Each time a subtask status change, the start time and the end time are saved in a seperate table automatically. +The time spent is automatically calculated for tasks and subtasks when the subtask is completed. + +- Changing subtask status from "todo" to "in pogress" logs the start time +- Changing subtask status from "in progress" to "done" logs the end time but also update the time spent of the subtask and the task + +The breakdown by user is also visible in the tasks details: +I \ No newline at end of file -- cgit v1.2.3