carpentries / carpentries/instructor-training

Distinguishing between faded examples & Parson's problems

Open
#1,827 0 comments 0 reactions 0 assignees View on GitHub
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.