Use a screencast to augment written documents.
Some people learn/understand audio-visual better than written examples.
The visual component of a screencast is an html file rendered by a web-browser.
I suggest putting the browser into Full Screen mode and adjusting the zoom so that the text fills the middle 50% of the screen. This screencast is currently adjusted for my screen; you may have to tweak it for your own screen.
Click/tap the footer to precisely advance to next panel.
Notes for the speaker may be included in a hidden html div.
The intention is that the notes will be visible for rehearsal, but hidden for recording. Perhaps the speaker could have the speaker notes displayed off to the side on a laptop running the same screencast section.
Speaker notes appear as orange text to distinguish from main content, and as a warning while recording that they should be hidden.
Speaker notes can be toggled by clicking/tapping the copyright notice at the end of the section.
During a screencast, it's often desirable to discuss an expression without being distracted by what the result with be. Screedcast offers a facility for simulating an evaluation.
Click/tap Clojure code examples to reveal the expression's evaluation.
(map inc [1 2 3]);; => (2 3 4)
Giving the impression of being at the repl also makes the screencast a little more familiar and engaging.
If a panel contains many code examples, you may want to re-hide the evaluations as you work your way through the discussion. Click/tap the expression again (not the evaluation) to re-hide.
Speaker note: Way too much text on this panel. Not a good example of a screencast panel.
Don't bother to drag the scroll-bar or use the mouse scroll wheel. Clicking the headers/footers will always advance exactly one screenful.
If you bump it and the screen gets a little bit displaced, simply click the nearest header/footer to precisely re-align the panel with the screen.
A good way to wrap up a screencast section is to put it into context. The 'What's Next' panel tells us what we just discussed and highlights the next topic.
This particular screencast series contains three sections. Since we just discussed Using Screedcast (section #2), we'll follow that up with a discussion on how to Create a screencast (section #3).
And since we're here, scroll just a tiny bit further to see the copyright and license banners. Clicking the copyright section will toggle the speaker notes.
This program and the accompanying materials are made available under the terms of the MIT License.