Using the Lesson Infrastructure

Overview

Questions

• What do lesson developers need to be able to do with The Carpentries lesson infrastructure?
• What are some common points of confusion for lesson developers working with the infrastructure?

Objectives

By the end of this session, participants should be able to…

• initialise and configure a new lesson website from a template repository.
• edit the (R) Markdown source file of an episode.
• help trainees to troubleshoot their issues with lesson setup and authoring.

Reading List & Homework

• CLDT episode: The Carpentries Workbench
  • Please follow the steps in the episode, creating and configuring a new lesson repository, while you read through the content.
  • Note down any problems you encounter along the way, no matter whether they were minor (i.e. slowed you down or confused you temporarily, but did not stop you from progressing) or major (i.e. you had to give up or ask for help).

Discussion Questions

• The reading/homework task for this week asked you to read through and follow the steps in the Carpentries Workbench episode of the CLDT curriculum.
  • Were you able to do this?
  • If you got stuck at any point while following those steps:
    • where did you get stuck?
    • were you able to find a solution to your problem and continue? if so, what did you do to find the solution?
• Although some experience of GitHub is specified as a prerequisite for CLDT, we can expect some trainees to arrive with little familiarity or confidence with the platform and the terminology associated with Git and GitHub. Furthermore, this may be the first time trainees have encountered a GitHub Pages project.
  • What “sticking points” do you anticipate among trainees learning to use the infrastructure to build a lesson website?
• What strategies could Trainers/The Carpentries adopt to support trainees as they learn these skills
  • before the training?
  • during training?
  • after training?

Useful Lesson Infrastructure Resources

• Introduction to The Carpentries Workbench
• The Carpentries Workbench Style Guide
• Component Guide
  • Provides a full list of the different classes of fenced div available in the infrastructure

Homework/Reading for Next Week

• CLDT Episode: How We Operate
• The information on Trial Runs provided to trainees during CLDT.
• Familiarise yourself with the list of open issues on the CLDT curriculum repository, especially those assigned to the ‘Beta Release’ milestone.
• The content of the next episode of this Trainer Training curriculum:
  • Structure of Collaborative Lesson Development Training
  • Scheduling trainings
  • What do Trainees require for certification?

Key Points

• Lesson developers will initialise a new lesson from a template repository, which they will then need to configure and start adding episodes to.
• Developers will often need some support with the first stages of lesson setup, especially if they are not yet familiar with GitHub and/or Markdown.