On Tue, 2004-10-12 at 00:44, Niklas Frykholm wrote:
> I've toyed a bit with literate programming, but I'm not really sold on 
> the idea. I guess my problem with "documentation as source" (or even 
> with "source as documentation", but that is a smaller gripe) is the 
> notion that a program only has one "story". Usually, I find that in my 
> programs there are many different stories: a story for a beginner user, 
> a story for an expert user, a story for someone who wants to extend the 
> module, a story for someone who wants to hack it, a story for someone 
> who wants to understand and study the technology behind it. And of 
> course, there can be stories can be in different languages. Trying to 
> put all these stories as well as the source code in the same document 
> tends to be confusing, at least for me.

     *smile*  Wonderfully put.

    -- Markus