Michael Czechowski
782e87705c
Pedagogical validation message rewrite across 17 English lesson modules and 5 localized variants (ar, de, es, pl, uk).
2.7 KiB
2.7 KiB
Tasks
Phase 1: Preparation
- Task 1.1: Audit existing tests for hardcoded validation message assertions; note any that need updating
- Task 1.2: Read each priority English module and draft replacement messages using the hint style guide (concept question / property hint / directional nudge)
Phase 2: English Priority Modules (100% answer-revealing)
- Task 2.1: Rewrite validation messages in
lessons/flexbox.json(6 messages) [P] - Task 2.2: Rewrite validation messages in
lessons/01-box-model.json(10 messages) [P] - Task 2.3: Rewrite validation messages in
lessons/03-colors.json(4 messages) [P] - Task 2.4: Rewrite validation messages in
lessons/12-positioning.json(5 messages) [P]
Phase 3: English Remaining Modules
- Task 3.1: Rewrite messages in
lessons/00-basic-selectors.json(15 messages) [P] - Task 3.2: Rewrite messages in
lessons/00-basics.json(4 messages) [P] - Task 3.3: Rewrite messages in
lessons/01-advanced-selectors.json(8 messages) [P] - Task 3.4: Rewrite messages in
lessons/04-typography.json(1 message) [P] - Task 3.5: Rewrite messages in
lessons/05-units-variables.json(3 messages) [P] - Task 3.6: Rewrite messages in
lessons/06-transitions-animations.json(8 messages) [P] - Task 3.7: Rewrite messages in
lessons/07-layouts.json(8 messages) [P] - Task 3.8: Rewrite messages in
lessons/08-responsive.json(8 messages) [P] - Task 3.9: Rewrite messages in
lessons/09-gradients.json(3 messages) [P] - Task 3.10: Rewrite messages in
lessons/10-tailwind-basics.json(16 messages) [P] - Task 3.11: Rewrite messages in
lessons/11-filters.json(4 messages) [P] - Task 3.12: Rewrite messages in
lessons/13-pseudo-elements.json(4 messages) [P] - Task 3.13: Rewrite messages in
lessons/grid.json(5 messages) [P]
Phase 4: Localized Variants
- Task 4.1: Update Arabic (ar/) localized modules with pedagogical messages [P]
- Task 4.2: Update German (de/) localized modules with pedagogical messages [P]
- Task 4.3: Update Spanish (es/) localized modules with pedagogical messages [P]
- Task 4.4: Update Polish (pl/) localized modules with pedagogical messages [P]
- Task 4.5: Update Ukrainian (uk/) localized modules with pedagogical messages [P]
Phase 5: Validation & Polish
- Task 5.1: Run
npm run format.lessonsto ensure JSON formatting consistency - Task 5.2: Run
npm run testand fix any test failures related to message text assertions - Task 5.3: Grep audit — verify no "Set " answer-revealing patterns remain in any lesson file
- Task 5.4: Spot-check a few lessons via
npm startto confirm messages render correctly in the UI