From: Charles Comstock <cc1@...>
Date: 2004-02-27T17:05:32+09:00
Subject: Re: Docs [Was Regarding PLD RPMs of rake and ruby-dbi and a plea to packagers]

Larry Felton Johnson wrote:

> Funny you should mention that.  I've been looking over the
> CWEB syntax thinking about writing a simple tangle/weave system
> in and for ruby as an exercise.  I've always been interested in
> literate programming, never really done anything with it except
> read the docs.  
> 
> I was thinking about something modelled on cweb as the source files,
> xhtml as the weave output, and ruby as the tangle output.
> 
> Larry
> 
> On Mon, Feb 23, 2004 at 08:23:46PM +0900, Mauricio Fernndez wrote:
> 
>>On Mon, Feb 23, 2004 at 01:18:14PM +0900, Aredridel wrote:
>>
>>>In addition to rather liking test-first coding (which I'm just now
>>>getting into), I like document-first coding.  Write tests (expect them
>>>to fail), write docs (expect them to be more complete than the code),
>>>then write code that fulfils the tests and matches the docs.
>>
>>Time to write RWEB? :-P
>>
>>-- 
Umm isn't RDOC basically RWEB?  I mean it's not really fancy as far as 
the weave output but I mean it's pretty similar really.  It's just the 
overall weave output isn't designed to be read in book form.  You could 
just make a new formatter for RDOC that was more article/bookish.

Charles Comstock