Docs: Updated

This commit is contained in:
Paul Beckingham 2016-05-21 20:36:43 -05:00
parent 90fd90594a
commit dc69e12276

View file

@ -40,22 +40,18 @@ Non-Goals
Reports Reports
------- -------
Anticipating all reporting needs is impossible, therefore custom reports are Anticipating all reporting needs is impossible, therefore custom reports are
required. Rather than copy the Taskwarrior design where flexibility is provided required. Rather than only provide the Taskwarrior design where flexibility is
via configurable options for fixed-format reports, Timewarrior will use a more provided via configurable options for fixed-format reports, Timewarrior will
flexible approach of providing configuration and data via an extension API. use a more flexible approach of providing configuration and data via an
This will not limit the kind of reports or supported formats that can be added. extension API. This will not limit the kind of reports or supported formats
that can be added.
Timewarrior will ship with several reports, which serve as example extensions Timewarrior will ship with several extension reports, which serve as example
for users to modify and improve, perhaps contribute back to the project. extensions for users to modify and improve, perhaps contribute back to the
project.
Purely as an example of what might be implemented, here are some report mockups: Timewarrior will also have a limited set of built-in reports, a minimally
functional tabular and chart report of tracked time.
./report.week.1.txt
./report.week.2.txt
./report.day.1.txt
./report.day.2.txt
./report.exc.week.txt
./report.summary.txt
Tags Tags
@ -113,7 +109,8 @@ The command set will include:
x Run extension 'x' x Run extension 'x'
There will be built-in commands, and an extensions mechanism that allows reports There will be built-in commands, and an extensions mechanism that allows reports
to be added as extensions, while being handled as though they were built-ins. to be added as extensions, although presented and handled as though they were
built-ins.
Undo Undo