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¶
- Fork the repo.
- Edit the class's Markdown under
docs/(for exampledocs/intro-to-home-assistant/). - 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.