Clarify the intent of the time estimate within the description of the Time Tracking feature.
The documentation page https://docs.gitlab.com/ee/user/project/time_tracking.html talks about the /estimate
and /spend
time-tracking quick actions, but the text is unclear about whether the estimated time applies to time remaining
or total time to complete the task
-- the closest it gets to addressing the issue is with this quote, near the top: "Add an estimate of the amount of time needed to complete an issue or a merge request." -- Unfortunately, this is exactly the kind of ambiguous text that two people could read and interpret either way, confirming whatever they already think it means. (i.e. time needed
could be inferred to mean "total time needed" or "additional time needed")
So, my request is to make this text very explicit, with wording such as:
- Set or Update the estimate of the total time (including time already spent) needed to complete the issue or merge request
OR
- Set or Update the estimate of how much more time will be needed (starting now) to complete the issue or merge request
(I would make a specific proposal, but I don't know how the field is supposed to be used, so I don't know which example text is correct)