docs: add spec, plan, and tasks for filters task wording fix (#12)

This commit is contained in:
2026-03-29 23:24:32 +02:00
parent c5641a8364
commit b25e6a4e20
3 changed files with 107 additions and 0 deletions

View File

@@ -0,0 +1,30 @@
# fix: rewrite CSS Filters tasks to describe visual outcomes instead of exact code
**Issue:** [#12](https://git.librete.ch/libretech/code-crispies/issues/12)
**Repository:** libretech/code-crispies
**Author:** libretech
**State:** open
**Labels:** none
## Problem
Pedagogy audit: the Filters module has a 100% copy-paste score. Every exercise gives the exact CSS declaration in the task text, so students can complete lessons without understanding the concepts.
## Requirements
- Rewrite ONLY the filters module (`lessons/11-filters.json`) task descriptions to describe the desired visual effect instead of the exact code
- Accept multiple valid values in validations (e.g., accept blur values between 2px and 8px instead of only 4px)
- Do NOT change any other module
## Example
- **Before:** "Add `filter: blur(4px)`"
- **After:** "Blur the background image to create a frosted-glass effect. Use a blur radius between 2px and 8px."
## Acceptance Criteria
1. All 4 filter lesson tasks describe visual outcomes, not exact CSS
2. Validations accept a range of valid values using regex patterns
3. Validation messages provide pedagogical hints without revealing answers
4. No changes to any file outside `lessons/11-filters.json`
5. Existing tests continue to pass