From: James Britt <jamesUNDERBARb@...>
Date: 2004-10-14T14:59:39+09:00
Subject: Re: documentation as source

Markus wrote:

> 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.

Where do all of these different stories go, if not together, such that 
when the code changes all of the stories are updated as well?

James