Pedagogical validation message rewrite across 17 English lesson modules and 5 localized variants (ar, de, es, pl, uk).
2.3 KiB
2.3 KiB
fix: validation error messages reveal the solution instead of guiding learning
Issue: #4 Repository: libretech/code-crispies Author: libretech State: open Labels: none
Issue Body
Pedagogy audit: 88% of exercises reveal the answer in error messages, creating a fail-then-copy loop. Change validation messages from 'Set padding: 1rem' to 'Which property adds space between content and the element edge?' This applies across all modules — start with flexbox, box-model, and colors (the 3 worst offenders).
Acceptance Criteria
- Validation error messages in flexbox, box-model, and colors modules must no longer reveal the exact CSS property-value answer
- Replacement messages should use pedagogical hints: concept questions, property-name hints, or directional guidance — never the literal solution
- All remaining English lesson modules with answer-revealing messages must also be rewritten
- Localized variants (ar/, de/, es/, pl/, uk/) of affected modules must be updated with equivalent pedagogical messages in each language
- Existing validations (type, value, options) must remain unchanged — only the
"message"field is modified - All existing tests must continue to pass
Scope
English priority modules (100% answer-revealing):
lessons/flexbox.json— 6 messageslessons/01-box-model.json— 10 messageslessons/03-colors.json— 4 messageslessons/12-positioning.json— 5 messages
English remaining modules (partial answer-revealing):
lessons/00-basics.json— 4 of 26lessons/00-basic-selectors.json— 15 of 18lessons/01-advanced-selectors.json— 8 of 49lessons/04-typography.json— 1 of 9lessons/05-units-variables.json— 3 of 5lessons/06-transitions-animations.json— 8 of 13lessons/07-layouts.json— 8 of 11lessons/08-responsive.json— 8 of 10lessons/09-gradients.json— 3 of 7lessons/10-tailwind-basics.json— 16 of 17lessons/11-filters.json— 4 of 7lessons/13-pseudo-elements.json— 4 of 8lessons/grid.json— 5 of 9
Localized variants (each language directory):
lessons/ar/— Arabiclessons/de/— Germanlessons/es/— Spanishlessons/pl/— Polishlessons/uk/— Ukrainian