From: Dave Thomas <dave@...>
Date: 2003-10-22T03:12:30+09:00
Subject: Re: RDoc and i18n


On Tuesday, Oct 21, 2003, at 13:08 US/Central, Austin Ziegler wrote:

> # :class: Foo
> # documentation for class Foo.
> # :method: Foo.bar
> # documentation for class method Foo.bar
> # :method: Foo#bar
> # documentation for instance method Foo#bar.
>

On the face of it, I'm not too keen on this kind of approach. The 
philosophy of RDoc is make document transparent, and in the same source 
file as the code.

We've all seen the problems that arise now when documentation is 
separate from code, and the code changes. I'd like to try to avoid this.

Cheers


Dave