From 6c711f696f73bc59813f6834ec241aef3b626cbd Mon Sep 17 00:00:00 2001 From: Frederic Guillot Date: Sat, 29 Aug 2015 20:00:53 -0400 Subject: Include documentation in the application --- doc/time-tracking.markdown | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 doc/time-tracking.markdown (limited to 'doc/time-tracking.markdown') diff --git a/doc/time-tracking.markdown b/doc/time-tracking.markdown new file mode 100644 index 00000000..8c65b16a --- /dev/null +++ b/doc/time-tracking.markdown @@ -0,0 +1,43 @@ +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". + +When you change the value of these fields, **the task time tracking values are updated automatically and becomes the sum of all subtask values**. + +Kanboard records the time between each subtask status change in a separate table. + +- 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 of all records is visible in the task view page: + +![Task timesheet](http://kanboard.net/screenshots/documentation/task-timesheet.png) + +For each subtask, the timer can be stopped/started at any time: + +![Subtask timer](http://kanboard.net/screenshots/documentation/subtask-timer.png) + +- The timer doesn't depends of the subtask status +- Each time you start the timer a new record is created in the time tracking table +- Each time you stop the clock the end date is recorded in the time tracking table +- The calculated time spent is rounded to the nearest quarter -- cgit v1.2.3