From: Phlip <phlip2005@...>
Date: 2008-08-14T20:42:26+09:00
Subject: Re: Documenting DSLs

Trans wrote:
> 
> Hey, has anyone thought about or worked on a "next gen" documentation
> system for handling Ruby DSLs?

I always figured a literate documentor would...

  - read the code
  - convert the comments to HTML
  - run the tests
  - insert the test code into the HTML
  - syntax-highlight the code
  - insert the test results into the HTML

That satisfies the goal "tests are documentation".

But when I tried to submit a proposal, with an introductory patch, to the 
maintainers of RDoc, I got flamed and I gave up. Great community here...

-- 
   Phlip