From: Bil Kleb <Bil.Kleb@...>
Date: 2004-10-12T19:44:17+09:00
Subject: Re: documentation as source

Randy W. Sims wrote:
> Are there any Ruby modules that allow documentation to act as source 
> code? 

require 'test/unit'

Then code test-first and you'll have executable documentation.

Code test-first with a partner, and you'll have /sane/ executable
documentation.

When test/unit2 appears, tests will become even more like documentation.

I've played with Literate Programming for over a decade and found
that it nearly always violates the DRY principal.  As a result, it
eventually gets out of sync and begins to lie.

Regards,
-- 
Bil Kleb, Hampton, Virginia
http://fun3d.larc.nasa.gov