carpentries / carpentries/instructor-training

Clarify that callouts are optional

Open
#1,160 7 comments 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
189
Forks
301
Avg merge
2d 12h
Merged PRs (30d)
9

Description

This came up in my teaching demo this morning and has come up in several demos before. Trainees were surprised that callouts weren't a required part of the lesson. They were trying to teach all of the callouts, which is a timing problem, especially for some of the older SWC lessons where there are many callouts. It would be good to emphasize somewhere in training and/or documentation that callouts are optional extras that Instructors can include or skip depending on time, the questions that learners are asking, and interest in particular topics.

Contributor guide

Open the contributing guide

Research direction

Review the instructor training and documentation areas to find where callouts are introduced. Update the relevant guidance so it states that callouts are optional and may be included or skipped based on time, learner questions, and topic interest. Done means instructors are unlikely to mistake callouts for required lesson content.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.