Instructions on formatting are in the README.md. Hidden code blocks are especially tricky, so watch out!
In general, the curriculum should introduce concepts through analogy, followed by several links from the analogy to real-life. Aim to build a consistent mental model of programs-as-worlds and objects-as-denizens.
Each chapter may end with a quiz.