From: Dave Thomas <Dave@...>
Date: 2002-05-21T02:27:21+09:00
Subject: Re: [RDoc etc] automatic documentation: using tests in addition to / instead of comments

Dossy <dossy@panoptic.com> writes:

> I definitely think having RDoc be Test::Unit-literate would
> be cool.  Pass RDoc over my unit tests and have it extract
> test cases and their conditions (the "message" passed to
> the assert_* methods maybe) ... but then, after all this,
> isn't it simply easier to just pretty-print your test
> cases as-is and let the reader do the intelligent work?

Say you're looking at method 'fred' in RDoc. In the documentation
there'll be hyperlinks to 'Examples of this in action'. Click it, and
up will pop the test methods.