carpentries / carpentries/instructor-training
Distinguishing between faded examples & Parson's problems
- Dominant language
- No language data
- Stars
- 189
- Forks
- 301
- Avg merge
- 1d 4h
- Merged PRs (30d)
- 7
Description
In the [Using Formative Assessments for Memory Management](https://carpentries.github.io/instructor-training/instructor/05-memory.html#attention-management-in-your-workshop) we suggest faded examples and Parson's problems, with links to Wikipedia articles for each. The faded example bullet links to an article on "Worked-example effect" within which "Faded worked examples" is one sub-definition. The Parson's problem wikipedia article also includes a sub-definition for a "Faded" variant. This makes it confusing to know what is meant by the first bullet for "faded example" as that is part of both the wikipedia articles.
Contributor guide
Research direction
Start with the “Attention management in your workshop” section of instructor/05-memory.html and follow both Wikipedia links for the faded example and Parson’s problem. Clarify the distinction in the bullet text or links so readers can tell which concept is intended, then check that the section no longer presents overlapping definitions.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100