From: Dave Thomas <pragdave@...>
Date: 2004-11-26T06:40:44+09:00
Subject: Re: [RDOC] Using unit-tests as examples for a documentation


On Nov 25, 2004, at 15:32, benny wrote:

> Now the idea: Why not use the examples in the unit-tests (at least the
> "positive ones") as link to a popup window "examples" in the
> HTML-documentation created by rdoc?

This has been raised before. The problem is that it's hard to work out 
which tests test which methods: method naming conventions would help, 
but even so you quite often have three test methods testing one 
production method.

An alternative might be to embed the UTs in the comment for the method, 
and then have TestUnit extract and run them automatically. I personally 
quite like that approach, although it would need some special markup 
that RDoc doesn't yet support.


Cheers

Dave