| 1 | = Tools for visualizing and quick editing of effort estimations = |
| 2 | |
| 3 | == Description == |
| 4 | |
| 5 | EstimationTools includes macros that visualize remaining effort estimations, e.g., as Burndown Chart, as well as an extension that allows inline editing of estimations in the query view. |
| 6 | |
| 7 | |
| 8 | == Bugs/Feature Requests == |
| 9 | |
| 10 | Existing bugs and feature requests for EstimationToolsPlugin are |
| 11 | [report:9?COMPONENT=EstimationToolsPlugin here]. |
| 12 | |
| 13 | If you have any issues, create a |
| 14 | [http://trac-hacks.org/newticket?component=EstimationToolsPlugin&owner=hoessler new ticket]. |
| 15 | |
| 16 | == Download == |
| 17 | |
| 18 | Download the zipped source from [download:estimationtoolsplugin here]. |
| 19 | |
| 20 | == Source == |
| 21 | |
| 22 | You can check out EstimationToolsPlugin from [http://trac-hacks.org/svn/estimationtoolsplugin here] using Subversion, or [source:estimationtoolsplugin browse the source] with Trac. |
| 23 | |
| 24 | == Example == |
| 25 | |
| 26 | === BurndownChart === |
| 27 | |
| 28 | Creates burn down chart for given milestone. |
| 29 | |
| 30 | This macro creates a chart that can be used to visualize the progress in a milestone (aka sprint or |
| 31 | product backlog). |
| 32 | For a given milestone and time frame, the remaining, estimated effort is calculated. |
| 33 | |
| 34 | The macro has the following parameters: |
| 35 | * `milestone`: '''mandatory''' parameter that specifies the milestone. |
| 36 | * `startdate`: '''mandatory''' parameter that specifies the start date of the period (ISO8601 format) |
| 37 | * `enddate`: end date of the period. If omitted, it defaults to either the milestones `completed' date, |
| 38 | or `due`date, or today (in that order) (ISO8601 format) |
| 39 | * `sprints`: list of comma-separated name of sprints to be included in calculation. Must be surrounded by |
| 40 | brackets. |
| 41 | * `width`: width of resulting diagram (defaults to 800) |
| 42 | * `height`: height of resulting diagram (defaults to 200) |
| 43 | * `color`: color specified as 6-letter string of hexadecimal values in the format `RRGGBB`. |
| 44 | Defaults to `ff9900`, a nice orange. |
| 45 | |
| 46 | Examples: |
| 47 | {{{ |
| 48 | [[BurndownChart(milestone = Sprint 1, startdate = 2008-01-01)]] |
| 49 | [[BurndownChart(milestone = Release 3.0, startdate = 2008-01-01, enddate = 2008-01-15, |
| 50 | width = 600, height = 100, color = 0000ff, sprints = (Sprint 1, Sprint 2))]] |
| 51 | }}} |
| 52 | |
| 53 | == Recent Changes == |
| 54 | |
| 55 | [[ChangeLog(estimationtoolsplugin, 3)]] |
| 56 | |
| 57 | == Author/Contributors == |
| 58 | |
| 59 | '''Author:''' [wiki:hoessler] [[BR]] |
| 60 | '''Contributors:''' |