carpentries / lesson-example

Example lesson using The Carpentries lesson template.
https://carpentries.github.io/lesson-example/
Other
64 stars 173 forks source link

Teaching Time versus Teaching Times? #349

Open psteinb opened 3 years ago

psteinb commented 3 years ago

While working on our deep-learning-intro lesson, the data scientists in us bumped our heads onto the question how to log individual teaching times per teaching module in the current lesson setup. The quick hack we came up with was to add a comment to the teaching field in the jekyll front matter.

For example, something like this:

---
title: "Classification by a Neural Network using Keras"
teaching: 30 # psteinb:50
exercises: 30 # psteinb:10
questions:
- "What is a neural network?"

For me as an instructor, a distribution of times helps tremendously to establish a trustworthy reference.

See also: https://github.com/carpentries-incubator/deep-learning-intro/issues/124

psteinb commented 3 years ago

So I guess, my question is what to do about this? Is this something being discussed among other instructors and lessons?

gcapes commented 3 years ago

Ah, the timing question!

I would say is that it's important to set realistic timings, which can only really be arrived at by teaching the material a few times and recording how long it took. As far as I know there's no mechanism to record this easily. However, unrealistically short timings are prevalent throughout the carpentries' lesson, but this is demotivating for both instructors and learners.

I brought this up for the shell lesson https://github.com/swcarpentry/shell-novice/issues/928 and we had a few timings reported as comments on the issue.

psteinb commented 3 years ago

Great comment @gcapes which I totally agree with. And I believe you put your finger right where it hurts: if the frontmatter lists a time which is unreasonable, this is a problem for me. So, how about two radical ideas:

We could and should discuss facilities in the lesson template which support people to record their timings (and submit them through a PR). Because only this view of a bunch of numbers (or summary statistics thereof) can provide me with a feeling of how long this module normally takes to teach. And normal here not only refers to the name of a distribution, but also to conveying and conceiving an expectation.