carpentries / instructor-training

Instructor Training
https://carpentries.github.io/instructor-training/
Other
175 stars 290 forks source link

Consider moving a copy of Lesson Introduction to lessons themselves #1097

Open angela-li opened 4 years ago

angela-li commented 4 years ago

Final comment from Trainer Training: we've found that new Instructors can forget to introduce themselves when teaching for the first time. Perhaps lesson content / instructor notes could include a link to the part of instructor training about Introductions? It's easy to forget what you've covered during Instructor Training when you're teaching for the first time.

karenword commented 2 years ago

This is something that could theoretically be accomplished via in-line instructor notes in lesson repositories with the new Workbench (yay!), but not sure about how/whether it would be practical to populate all lessons. @zkamvar what do you think about moving this over to https://github.com/carpentries/workbench/discussions (or some other place in your realm) maybe as a broader topic about using Instructor Notes in ways that repeat across curricula?

zkamvar commented 2 years ago

@karenword shared snippets across curricula is an interesting concept! In theory, since it would likely be static content, we could add it as HTML in the varnish syllabus template (and yes I mean template): https://github.com/carpentries/varnish/blob/98b83156958fc1d9c24af58190c79ea05fa1c56e/inst/pkgdown/templates/content-syllabus.html#L19

The only challenge would be allowing people to discard this templating if they don't want it, but that can be accomplished by yet another variable in config.yaml.