carpentries / instructor-training

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

Jargon definitions needed #1655

Closed marklcrowe closed 3 months ago

marklcrowe commented 5 months ago

How could the content be improved?

In episode 15 there is a discussion exercise about definitions of some jargon terms. There aren't definitions included in the manual at this point, and I've not been able to find any good source of definitions for those six terms. Most of them I've been able to track down somewhere, but I've yet to find a clear and concise description of perhaps the most critical, which is what a lesson is (other than a collection of episodes, but that's just a circular definition since an episode is defined as part of a lesson). Would it be possible to provide definitions, links to definitions, or consider dropping this actvity?

Which part of the content does your suggestion apply to?

https://carpentries.github.io/instructor-training/15-carpentries.html#test-yourself

brownsarahm commented 5 months ago

@sheraaronhurt are there official definitions for these terms somewhere that you could help us find (and/or let me know if you are the wrong person to ask)

If not maybe this is a good trainer meeting topic? @ndporter

sheraaronhurt commented 5 months ago

@brownsarahm this is a great question. This came up at the past trainer meeting. I am going to check with the Core Team to see but if not, I will definitely add as an upcoming trainer meeting topic.

annajiat commented 5 months ago

I have tried to find the official definitions and linked as follows:

I had linked to the Curriculum Development Handbook which may get retired as discussed in https://github.com/carpentries/curriculum-development/issues/81

It would be great to learn if there are more appropriate references to the six jargons above in the context of The Carpentries.

Tagging @tobyhodges for potential input.

Voting to add the solution to the activity after choice of the definitions is finalized.

kariljordan commented 5 months ago

Some of these terms are also defined in the community glossary.