Add docs on milestone percentage stats

What does this MR do?

• Clarify how the milestone percentage is calculated in the docs.
• Include example image of milestone.

cc// @abuango

• https://gitlab.zendesk.com/agent/tickets/76666