Literate Programming for the 21st Century

A session at Open Source Bridge 2013

Tuesday 18th June, 2013

4:45pm to 5:30pm (PST)

Donald Knuth once wrote:

bq. _Let us change our traditional attitude to the construction of programs: Instead of imagining that our main task is to instruct a computer what to do, let us concentrate rather on explaining to human beings what we want a computer to do._

He then wrote a series of papers and a book about how programming shouldn't be a collection of computer-oriented files with comments, but a human-focused document sprinkled with code. He called his programmatic idiom, _Literate Programming_.

Doug McIlroy and many others have claimed verbosity, and with the exception of some projects, like Docco, Literate Programming became an out-dated concept from last century's academia. However, succinct languages like Scala and Clojure, as well as a desire to bring community members together to work on open source projects, literate programming may have found its place.

In this session, I'll talk about the good and challenging aspects of literate programming and how it relates to the modern agile developer. And since success requires good tools, I'll demonstrate the concepts using "org-mode":http://www.orgmode.org and its Babel project to _tangle_ architectural thoughts and developer notes with code to implement a vibrant, helpful document for your peers to make your code easier to understand and maintain.

About the speaker

This person is speaking at this event.
Howard Abrams

A poet in love with the absurd, his family, and his own hubris.... oh, and Lisp. bio from Twitter

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

Tell your friends!


Time 4:45pm5:30pm PST

Date Tue 18th June 2013

Short URL


Official session page


View the schedule



See something wrong?

Report an issue with this session