carpentries / carpentries/instructor-training

Clarify live coding vs. live demonstration

Open
#1,779 0 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

### How could the content be improved?

Per #1558 there has been considerable discussion about the merits of referring to Carpentries-style teaching as "live coding" (current practice) vs. "live demos". Live coding is consistent with published literature (mainly in computer science and engineering education) and is how we've done it. Live demos/demonstrations is technically more inclusive of Carpentries workshops that do not focus on coding (spreadsheets, OpenRefine, etc.). The PR is being closed because of the length of time it's existed without resolution, but the question is worth revisiting at a later time.

### Which part of the content does your suggestion apply to?

episodes/17-live.md

Contributor guide

Open the contributing guide

Research direction

Start by reading episodes/17-live.md and the discussion referenced in #1558 to understand the competing terms and their teaching-context implications. The work is done when the terminology decision is resolved and the relevant content is updated consistently.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.