Files
code-crispies/specs/004-pedagogical-messages/tasks.md
Michael Czechowski 782e87705c docs: add spec, plan, and task breakdown for issue #4
Pedagogical validation message rewrite across 17 English lesson
modules and 5 localized variants (ar, de, es, pl, uk).
2026-03-28 19:21:24 +01:00

40 lines
2.7 KiB
Markdown

# 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.lessons` to ensure JSON formatting consistency
- [ ] Task 5.2: Run `npm run test` and fix any test failures related to message text assertions
- [ ] Task 5.3: Grep audit — verify no "Set <kbd>" answer-revealing patterns remain in any lesson file
- [ ] Task 5.4: Spot-check a few lessons via `npm start` to confirm messages render correctly in the UI