Human-Readable Explanations

Phase 1 stretch feature. The calculator displays a plain-English explanation of the current notation as the user builds it, updating live below the notation display.

Examples

Notation	Explanation
2d20kh+5	Roll 2d20, keep the highest, add 5
4d6kh3	Roll 4d6, keep the highest 3
6d[0..5]kh4	Roll 6 dice (0–5), keep the highest 4
2d%kl	Roll percentile with 1 bonus die
d20+5->d8(n20?C)+3	Roll d20+5, then d8+3 (Perkins crit on natural 20)

Learning Ramp

Combined with the Template Library (Phase 2) and Natural Language Input (Phase 2), this creates a learning loop:

1. User picks a template → generates notation
2. Explanation shows what it means in plain English
3. User starts to recognize patterns
4. User begins typing notation directly

The original CritDice had this feature — it’s a proven UX pattern worth carrying forward.

See also: UI Reference, Natural Language Input, Notation Spec