carpentries / instructor-training

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

Location of further discussion of Code of Conduct #1701

Open maneesha opened 1 month ago

maneesha commented 1 month ago

How could the content be improved?

Inclusive Practices in a Carpentries Workshop notes "We will discuss the Code of Conduct in greater detail in Part 4 of this training during our discussion of Working with your team."

This is actually in episode/part 21, so I offer two suggestions:

  1. Consistency in how we refer to segments of our lessons, as "part" or "episode" etc.
  2. Linking to that section when we refer to it.

Which part of the content does your suggestion apply to?

https://carpentries.github.io/instructor-training/09-eia.html#inclusive-practices-in-a-carpentries-workshop

brownsarahm commented 1 month ago

we switched from day 1/2 morning/afternoon to parts 1-4.

I think that we should:

  1. link as suggested
  2. add a trainer note... somewhere? that explains that "part" term.
maneesha commented 1 month ago

I see the "part" designations now in the sidebar ToC. We note when each part has a break and when each part ends but do not note when each part begins. It could be implicitly understood but maybe make that more explicit?

brownsarahm commented 1 month ago

for part 1/3 this is straightforward, we can change the titles of the welcome episodes.

For part 2/4 maybe it's worth adding a small welcome episode to each. I know in practice, I tend to do some sort of warmup/icebreaker at these points anyway, so it would impact the documented time, but possibly bring it closer to real world time?

(the end part 1 and end part 3 are ~ "break" episodes)