Versioned Literate Programming for Tutorials

A session at Write the Docs

Tuesday 9th April, 2013

10:40am to 11:00am

This talk will explore the authoring of programming tutorials where each step of the tutorial involves code snippets that build on the code presented in earlier steps.

Because such tutorials are primarily exposition in human language, but contain code snippets that should be executable if extracted, the approach has a lot in common with Literate Programming.

At the same time, because the tutorials effectively guide the reader through the construction of the code, step-by-step, there is also a lot in common with Version Control.

Hence I describe this approach as “Versioned Literate Programming”.

I don’t (yet) have a good toolkit for this sort of tutorial authoring and so the talk will mostly focus on the ideas and challenges involved as well as some of the different approaches I’ve attempted over the years of thinking about this.

About the speaker

This person is speaking at this event.
James Tauber

CEO @eldarion • Entrepreneur, Web and Python developer • Biblical Greek, Linguistics, EdTech, Music Theory, Maths, MOOCs • Australian expat, Christian bio from Twitter

Sign in to add slides, notes or videos to this session

Tell your friends!

When

Time 10:40am11:00am PST

Date Tue 9th April 2013

Short URL

lanyrd.com/scfpdr

View the schedule

Share

See something wrong?

Report an issue with this session