The provisional Puzzle rating: an info icon and a tooltip #444

New issue

Closed

opened 2026-10-16 08:20:32 +00:00 by root · 3 comments

root commented

2026-10-16 08:20:32 +00:00

(Migrated from gitlab.core-project.space)

Parent

#440

What to build

A provisional Puzzle rating says so, without a cryptic "?".

While the API flags the Puzzle rating provisional (deviation above 110, computed in the API; the front does not know the threshold), an info icon sits next to it on the Puzzles page.
Hovering, focusing or tapping the icon shows a tooltip: "Provisional rating — it moves quickly at first while we learn your level." / « Classement provisoire — il évolue vite au début, le temps d'évaluer votre niveau. » (ADR 0025).
Once the rating settles, the icon is gone. No badge text, no countdown.
Uses the design system's tooltip; if it has none, one is added there, with a story, reachable by keyboard and announced to screen readers.

Seam: S3 (the app's router with the API fakes). Covers stories 18-19 of #440.

Acceptance criteria

A provisional Puzzle rating shows the icon; a settled one does not.
The tooltip opens on hover, keyboard focus and tap, in English and French.
The icon has an accessible name and the tooltip is announced.
The icon updates after a result that settles the rating, with no reload.
The gate is green (CONTRIBUTING.md, "The five commands").

## Parent #440 ## What to build A provisional Puzzle rating says so, without a cryptic "?". - While the API flags the Puzzle rating provisional (deviation above 110, computed in the API; the front does not know the threshold), an info icon sits next to it on the Puzzles page. - Hovering, focusing or tapping the icon shows a tooltip: "Provisional rating — it moves quickly at first while we learn your level." / « Classement provisoire — il évolue vite au début, le temps d'évaluer votre niveau. » (ADR 0025). - Once the rating settles, the icon is gone. No badge text, no countdown. - Uses the design system's tooltip; if it has none, one is added there, with a story, reachable by keyboard and announced to screen readers. Seam: S3 (the app's router with the API fakes). Covers stories 18-19 of #440. ## Acceptance criteria - [ ] A provisional Puzzle rating shows the icon; a settled one does not. - [ ] The tooltip opens on hover, keyboard focus and tap, in English and French. - [ ] The icon has an accessible name and the tooltip is announced. - [ ] The icon updates after a result that settles the rating, with no reload. - [ ] The gate is green (`CONTRIBUTING.md`, "The five commands").

root commented

2026-10-16 08:21:29 +00:00

(Migrated from gitlab.core-project.space)

marked this issue as related to #440