The Literate Programs Wiki

| No Comments | No TrackBacks

I've put up the Excelsior SF generator documentation as a new article in the LiteratePrograms Wiki. To quote the wiki's Welcome page:

LiteratePrograms is a unique wiki where every article is simultaneously a document and a piece of code that you can view, download, compile, and run by simply using the "download code" tab at the top of every article. See Insertion sort (C) for a simple example. To date we have 435 articles.

Based on Donald Knuth's concept of literate programming, LiteratePrograms is a collection of code samples displayed in an easy-to-read way, collaboratively edited and debugged, and all released under the liberal MIT/X11 License (see Copyrights) so that anyone can use our code and text for any purpose.

The wiki lists programs in 67 languages.

For more on Literate Programming, see www.literateprogramming.com/. This site starts by quoting Donald Knuth's Literate Programming (1984), from Literate Programming, CSLI, 1992, page 99:

I believe that the time is ripe for significantly better documentation of programs, and that we can best achieve this by considering programs to be works of literature. Hence, my title: "Literate Programming."

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.

The practitioner of literate programming can be regarded as an essayist, whose main concern is with exposition and excellence of style. Such an author, with thesaurus in hand, chooses the names of variables carefully and explains what each variable means. He or she strives for a program that is comprehensible because its concepts have been introduced in an order that is best for human understanding, using a mixture of formal and informal methods that reinforce each other.

No TrackBacks

TrackBack URL: http://www.j-paine.org/cgi-bin/mt/mt-tb.cgi/14

Leave a comment

About this Entry

This page contains a single entry by Jocelyn Ireson-Paine published on November 19, 2007 2:13 AM.

Feature Integration Theory was the previous entry in this blog.

No × in Sex is the next entry in this blog.

Find recent content on the main index or look in the archives to find all content.