fix: replace answer-revealing validation messages with pedagogical hints #6

libretech · 2026-03-28T19:42:03+01:00

libretech commented

2026-03-28 19:42:03 +01:00

Summary

Replace answer-revealing validation messages with pedagogical hints across all lesson modules
Rewrite 59+ validation messages from direct answers (e.g., "Set padding: 1rem") to guiding questions/hints (e.g., "Which property adds space between content and the element edge?")
Cover all 12 English lesson modules plus all localized variants (ar, de, es, pl, uk)
Priority modules addressed: flexbox, box-model, and colors (the 3 worst offenders identified in the audit)
Add spec, plan, and task breakdown documentation

Related to #4

Changes

lessons/*.json — Rewrote validation message fields in 14 English lesson files to use pedagogical hints instead of revealing answers
lessons/{ar,de,es,pl,uk}/*.json — Updated all localized lesson files with equivalent pedagogical messages in each language
specs/004-pedagogical-messages/ — Added spec, implementation plan, and task breakdown

Test Plan

Existing unit tests continue to pass (validation logic unchanged, only message strings updated)
Manual review of message rewrites to ensure they guide learning without revealing answers
Verified all JSON files remain valid and properly formatted

## Summary - Replace answer-revealing validation messages with pedagogical hints across all lesson modules - Rewrite 59+ validation messages from direct answers (e.g., "Set padding: 1rem") to guiding questions/hints (e.g., "Which property adds space between content and the element edge?") - Cover all 12 English lesson modules plus all localized variants (ar, de, es, pl, uk) - Priority modules addressed: flexbox, box-model, and colors (the 3 worst offenders identified in the audit) - Add spec, plan, and task breakdown documentation Related to #4 ## Changes - `lessons/*.json` — Rewrote validation `message` fields in 14 English lesson files to use pedagogical hints instead of revealing answers - `lessons/{ar,de,es,pl,uk}/*.json` — Updated all localized lesson files with equivalent pedagogical messages in each language - `specs/004-pedagogical-messages/` — Added spec, implementation plan, and task breakdown ## Test Plan - Existing unit tests continue to pass (validation logic unchanged, only message strings updated) - Manual review of message rewrites to ensure they guide learning without revealing answers - Verified all JSON files remain valid and properly formatted

libretech added 2 commits 2026-03-28 19:42:04 +01:00

docs: add spec, plan, and task breakdown for issue #4 782e87705c

Pedagogical validation message rewrite across 17 English lesson
modules and 5 localized variants (ar, de, es, pl, uk).

feat: implement #4 — replace answer-revealing validation messages with pedagogical hints c560676544

Rewrite ~120 validation error messages across 17 English lesson modules
and their localized variants (ar, de, es, pl, uk) to use concept questions,
property hints, and directional nudges instead of revealing the exact
CSS property-value answers.

Priority modules (flexbox, box-model, colors, positioning) fully rewritten.
All remaining CSS modules updated. Only message strings changed — no
validation logic modifications.

libretech closed this pull request

2026-03-28 20:00:18 +01:00

Pull request closed

Please reopen this pull request to perform a merge.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: public/code-crispies#6