From c64d2777894f03f5fb476fbde40c960292d4a905 Mon Sep 17 00:00:00 2001 From: Stefan Glase Date: Thu, 13 Feb 2025 22:44:50 +0100 Subject: [PATCH] docs: improve documentation of the reference estimates --- docs/changelog.md | 1 + docs/features.md | 7 +++++++ 2 files changed, 8 insertions(+) diff --git a/docs/changelog.md b/docs/changelog.md index 426161df..bb08a420 100644 --- a/docs/changelog.md +++ b/docs/changelog.md @@ -14,6 +14,7 @@ category: Administration * chore: simplify Docker configuration for testing * feat: ensure compatibility with Jira 10.3.0 * feat: ensure compatibility with Jira 10.4.0 +* docs: improve documentation of the reference estimates ### [24.10.0] - 2024-10-29 diff --git a/docs/features.md b/docs/features.md index 3c7562c4..29297206 100644 --- a/docs/features.md +++ b/docs/features.md @@ -46,6 +46,13 @@ The user guide explains how to [participate in a Scrum Poker session](/participa When participants hover over the possible cards they can choose from during a Scrum Poker sessions they see a list of references to previous sessions they participated in with the same estimate agreed on. +Reference estimates are calculated by the following formula: + +* the reference estimate has the hovered estimate as the agreed estimate +* the current user has either started the session, confirmed the estimate or participated on the session with a vote + +The reference estimates are sorted by age and the youngest sessions are presented first. + See this feature in action in the user guide on the page that shows how to [participate in a Scrum Poker session](/participate-in-scrum-poker-session). ### Define your own card sets