Structure #

Making with Code is organized into courses, units, and lessons. Courses are the highest-level container for content. They contain one or more units. Units are clusters of content organized around essential questions, providing materials to orchestrate student learning for 1-2 months. Lessons are the finest level of organization, representing one class meeting. Lessons will be the hardest to adapt to different school schedules, so using lessons is optional. Courses and units are purely organizational structures, while lessons are also themselves a content type.

Content types #

The following content types are implemented. For each, ensure that type: contenttype is in the page’s front matter.

• course: Introduces a course.
• unit: Introduces a unit.
• lab: A guide for students through a hands on exploration of a particular topic.
• check-up: An at-home activity to review past content and prepare for future lessons.
• resource: A chunk of content such as a handout, a homework question, a mini-lesson, or a set of slides.
• teaching: A pedagogical overview, introducing the content to a teacher preparing to use it. Each course, unit, lesson, and module may have teaching content.
• notes: Pedagogical details related to a specific implementation of the content.

Courses, units, and labs are implemented in Hugo as branch bundles, which means each page is built from _index.html and it has access to all the other pages in its directory. Teaching and notes are implemented as pages within branch bundles.

File structure #

Here is an example file structure showing the various content types.

content/
├── _index.md
└── courses
   ├── _index.md
   └── cs9
       ├── _index.md
       ├── notes_hk_19_20.md
       ├── teaching.md
       └── unit00
           ├── _index.md
           ├── checkups
           │   ├── _index.md
           │   ├── hw_code_practice
           │   │   └── _index.md
           ├── labs
           │   ├── _index.md
           │   ├── lab1_terminal
           │   │   └── _index.md
           ├── notes.md
           ├── resources
           │   └── _index.md
           └── teaching.md