From: Gregory Brown <gregory.t.brown@...>
Date: 2007-01-10T14:34:37+09:00
Subject: Re: [ANN] Dhaka-1.0.0 now with RDoc

On 1/9/07, Mushfeq Khan <mushfeq.khan@gmail.com> wrote:
> Hi,
>
> I'll start including more code in the RDocs. The most important classes -
> really the only important classes - are Grammar, Tokenizer and Evaluator.
> These are where the hacking occurs. While the test suites contain several
> examples of each class, they are admittedly complex. I'm strongly for the
> idea that good examples are the best kind of explanation, the simpler the
> better. If you have ideas for such examples, let me know.

Something like parsing CSV or JSON would be a great reference.  Both
have fairly simple rules...
Thanks for pointing at these classes.  What we tried to do in Ruport
(though it needs updating!) is have our readme display as the front of
the RDoc and do a quick description of the most important classes
right in the Readme, so people know right where to go.

Maybe that'd help make it easier for folks to find the relevant docs
in Dhaka as well.