Skip to content

Teach these classes

Every class on this site is plain Markdown in a public GitHub repo, licensed CC BY 4.0. Fork it, swap in your own gear and stories, and teach it at your makerspace, library, or hackerspace.

How

  1. Fork the repo.
  2. Edit the class's Markdown under docs/ (for example docs/intro-to-home-assistant/).
  3. Push. GitHub Actions rebuilds the website and the printable documents for you.

How the builds work

Each class folder holds a speaker outline and an attendee handout. Those two Markdown files become both the pages on this site and the docx/PDF downloads, rebuilt on every push.

One rule: keep outline.md and handout.md plain Markdown, with no HTML or theme-specific syntax, so the print versions stay clean.

The repo README covers local previews and the rest of the plumbing.

License

CC BY 4.0: use it, remix it, teach with it, as long as you keep an attribution link back to the repo.