Overview
progress is a new semantic that can be defined on any tracker. It belongs to Tracker plugin. It's a float number between 0 and 1 and corresponds to a percentage of completion of something.
Pretty much like timeframe, there might be several ways to compute progress:
- based on the effort
- based on the count of linked artifacts
This new semantic is exposed in REST API and can be imported/exported in Tuleap XML.
Effort based
Tracker administrator select two numeric fields, one that represents the Total Effort (total_effort here after) and one that represent the Remaining Effort (remaining_effort here after).
The progress is computed with remaining_effort / total_effort
Edge case that lead to an error:
- total_effort is 0
- total_effort is negative
- remaining_effort is negative
- remaining_effort bigger than total_effort
Count based
Tracker must have an artifact link field.
For this first implementation
- only
_is_child links are taken into account
- it only counts direct links (so no grand children are taken into account for instance):
nb open/nb total
- to be consistent with story #9090, all children are taken into account into the computation, even those that cannot be seen due to permissions.