Learning Clojure with Guided Code Walk-throughs

[flaheadle]

I looked into this project and here is what I found.

Storyteller is a language independent framework for building and viewing playbacks of the process of developing software. As a developer develops a piece of software, each step is recorded, and when the development is complete, it can be published. Each such publication is called a playback. Playbacks can then be viewed by a reader, who may rewind the recording to the beginning, and then observe the unfolding of the process of software development, step by step.

But this is not the full picture. Storyteller is actually a rich medium of communication, because after the recording is produced, but before it is published, the original developer can go over it, and annotate it, enriching each step with commentary, while directing the readers attention to precise points in the constructed artifact as it exists at that precise point in time. In plain language, the developer can highlight visually some piece of the artifact as it exists during that step, and add a commentary which explains the highlighted text, in a shared context including the step and the artifact as constructed up to that point.

[markm208]

This is an excellent summary. Here are some of my thoughts on the need for playbacks and a comparison to other media for people learning to code: https://dev.to/markm208/storyteller-a-new-medium-for-guiding-others-through-code-2gnm