From: Phlip <phlip2005@...>
Date: 2009-03-13T10:42:59+09:00
Subject: Re: Poll: what documentation method do you use?

john maclean wrote:

> * malining list and ask

maligning the list? How could we?? (-:

> * none of the above

I wrote a QnD documenter called "ripdoc", based on Ruby1.9 Ripper. That means it 
uses Ruby's own parse tree to lex Ruby. Then I traverse this tree and emit HTML 
with CSS tags.

Then, I documents the test cases. I move the exemplary ones to the top, put them 
into thematic order like an outline, and write comments all over them.

This page contains the result:

   http://assert2.rubyforge.org/

-- 
   Phlip