Update live code to live demos in 17-live.md

[ndporter]

1. Replace "coding" in most instances with "demo" or related words to make more general
2. Update line 33 to reflect both online and in-person workshops
3. Remove wikipedia "live coding" link as it refers to live coding as a research or artistic tool, but doesn't reference pedagogy at all
4. Added callout on live coding/demos

[github-actions]

Thank you!

Thank you for your pull request 😃

🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

• 🎯 correct output
• 🖼️ correct figures
• ❓ new warnings
• ‼️ new errors

Rendered Changes

🔍 Inspect the changes: https://github.com/carpentries/instructor-training/compare/md-outputs..md-outputs-PR-1558

The following changes were observed in the rendered markdown documents:

 17-live.md | 56 ++++++++++++++++++++++++++++++++++++--------------------
 md5sum.txt |  2 +-
 2 files changed, 37 insertions(+), 21 deletions(-)

What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible.

This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

⏱️ Updated at 2023-08-02 13:14:34 +0000

[brownsarahm]

I picked at a few places specifically, but I actually think that we should use "demonstration" throughout because full words are more inclusive than shortenings for non native english speakers, I think.

It's also more consistent to use the exact same term throughout instead of two forms of it.

[brownsarahm]

Suggested change

	gives general tips for an effective participatory live demo presentation. We will
	gives general tips for an effective participatory live demonstration. We will

"demo presentation" reads funny to me

[brownsarahm]

Suggested change

	- Live demos forces the instructor to slow down.
	- Live demonstration forces the instructor to slow down.

or live demo maybe, but "live demos" feels like a mismatch of plurality?

[brownsarahm]

this is actually code, so I think here, live "coding" is actually more accurate and we should augment the exercise with reflection on what we can learn from this that applies to non-coding contexts

[brownsarahm]

the "error message" part may not translate to non-coding contexts, but i'm not sure what the best fix is here.

[JCSzamosi]

Error messages defnitely come up in non-coding contexts IME.

[brownsarahm]

Suggested change

	Live demos fits well into the practice-feedback model we have been discussing - by providing
	Live demonstration fits well into the practice-feedback model we have been discussing - by providing

i think using the full work is better for non native english speakers, but would accept the singular of the shortcut

[ha0ye]

@brownsarahm - I am internally amused about people reading "live demo" and then expecting to see "Carpentries Live Demolitions", but your suggestion is excellent!

[villanueval]

This is not entirely correct, although I see the distinction of these two lessons. Both use some use of functions. Might change it to "Some lessons might not include coding..."

[ragamouf]

Following today's discussion in the trainer meeting, my consideration into this change comes to this:
If we teach a cohort of trainees with no experience coding, programming, developing software, then it is up to us to explain the place of live coding in our pedagogy, and our emphasis on "participatory live coding". I don't agree with the wholesale change to replace 'coding' with 'demonstration' or other general presentation forms because it takes the learner away from the new mental model that we are teaching, which is associated explicitly with programming skills. When words and concepts are unfamiliar to learners, we can teach them to embrace the discomfort.

[JCSzamosi]

The reason I don't fully agree with this is that we do, in fact, have quite a bit of curriculum that does not involve coding. The open refine and spreadsheet lessons in the DC and LC curricula, at least. I would even go so far as to say that the Git lessons don't strictly speaking teach coding, but rather interactively interacting with Git on the command line.

The point, as I understand it, is not to avoid the word "coding" because it might be unfamiliar or intimidating, but to specifically be inclusive of people who are teaching those lessons, and to avoid confusion by making it clear that the live participatory stuff that we do is not limited to coding.

[brownsarahm]

I really appreciate @ragamouf's comment

When words and concepts are unfamiliar to learners, we can teach them to embrace the discomfort.

I propose that we take a careful read through how we are framing things in this episode that we always do "participatory live demonstration" and that it is mostly "participatory live coding".

We want to include people who want to teach data organization in spreadsheets or cleaning with openrefine, but not affirm people's fear of coding. We teach in this lesson about meeting our learners where they are and encouraging them to use these tools even if they are afraid, I think we need to keep modeling that here.