Lessons From Planning My First Software Carpentry Workshop


I hosted my first Software Carpentry workshop on December 18th and 19th 2017 in Knoxville Tennessee with my co-instructors Meg Staton and Drew Steen.

I tried to follow the general recommendations and most things worked out great. Here are some lessons learned.

The Software Carpentry logo


Consider digital and print flyers

I liked the inclusion of "tear off" tags for our flyer workshop. When I saw it on this digital display, I had to laugh. Next time we'll distribute print and digital versions of the flyer.

Our flyer Our flyer had tear offs which sounds great until you see it on one of those digital bulletin board displays around campus.

Charging a registration fee

The Software Carpentry recommends charging a nominal registration fee to reduce no-shows. Unfortunately this added a layer of administrative red tape for us, so we kept registration free. How did that work out for us?

Well, we sold out for 35 tickets within 24 hours, with a waitlist of 25. I emailed out a week before and 72 hours before asking for people to cancel if they could not make it. This netted me 11 cancellations, but the workshop started on a Monday! This meant that most waitlisters were notified over the weekend and did not end up claiming their tickets. This is in addition to the five students who no-showed without notice.

So ultimately we ended up with 31 out of 35 seats filled, which isn't so bad.

Using Eventbrite

Because our workshop was free, there was no fee for using Eventbrite. Eventbrite provides the basic functions necessary to manage the event: you can download an attendee list including email, or you can contact attendees via Eventbrite.

Eventbrite also has a waitlist functionality. After the tickets sold out, I enabled the waitlist and people could join the waitlist, managed entirely by Eventbrite. When I received cancellations, I just had to "release the tickets" and the waitlister has a set period of time (i set it to 24 hours) to respond and claim their ticket.

Eventbrite also has a widget that lets participants purchase tickets right on your course website.

The Eventbrite widget on our software carpentry website The Eventbrite widget will allow your users to purchase tickets right on your website (or in this case, join the waitlist).

All together this is great. Managing an attendee list and waitlist via emails is a deceptively time consuming task. Even though its quite easy, not getting barraged with emails (almost 70 emails with people registering alone!) is a great perk. I would use Eventbrite again, at least for free events.

The Eventbrite page The Eventbrite event management page.

Preparing Your Lectures

  • Pre-generate your ether pad with questions. I am sharing my pre-generated etherpads: Unix, R, Git
  • Create slides for the images in the material.
  • Look at the github repo for the lessons and know the issues and alternatives.

The carpentry workshops are live code only without slides. The thing is, graphics are great for mental models, and slides can help with instructor pacing a lot better than the free-text of the lesson plans.

The open-source nature of Software Carpentry materials means that people have all sorts of suggestions for how to do things differently. Some lessons may have variants available online that you will prefer. The Git lesson, for example, is command-line heavy.

Day of suggestions

  • Share links liberally. In the chatbox of etherpad, on the website, within each etherpad. Link to data downloads, the etherpads, the course website.
  • Encourage your students to share a bit about themselves and why they are attending. If the workshop is too big to do this verbally, do it digitally. Knowing what your students expect to learn can help you trim topics if (when) you run out of time.
  • Plan on running out of time! The Software Carpentry workshops have time estimates but they are beyond optimistic.