Design Guidelines

Design guidelines

Source of truth: this wiki page.

No superfluity (owner, 2026-10-26)

There are a lot of this superfluity in the UI. Record this as a design guideline, avoid superfluity everywhere and write direct sentences.

Said on the "Not quite" banner after a spoken answer: it repeated the answer that the card above it already showed, and did not say what was wrong.

• Show nothing the learner already sees on the same screen.
• Say what happened, in one direct sentence. No lead-in, no softening.
• A message tells the learner what was wrong, not what was right: the card already shows the right answer.
• Cut a line, a label or a word that changes nothing the learner does next.
• Where there are several scripts, show the one being learnt; where several are being learnt, the first.
• Review each screen with: "What would the learner miss if this went?" If nothing, remove it.