carpentries / carpentries/instructor-training

Suggest speaking, then typing (instead of speaking as you type)

Open
#1,828 1 comment 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

In the [What to Display](https://carpentries.github.io/instructor-training/instructor/05-memory.html#what-to-display) section, we suggest Instructors "speak commands as they type them on the screen." One of the most consistent points of feedback I've gotten from people who are starting teaching using live coding practices is that it's hard to type and speak at the same time. I always tell them that you don't actually need to simultaneously speak and type -- they can say what they are going to do and then type it out (or type it out and then say what they typed out... or both). I think it would be useful to change this language to make it clear that we don't expect people to simultaneously talk and type.

Contributor guide

Open the contributing guide

Research direction

Start with the linked What to Display section in the instructor training lesson and locate the sentence about speaking commands as they are typed. Revise the wording to clarify that instructors may speak before or after typing rather than simultaneously, then preview the lesson to confirm the guidance is clear.

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
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.