Re: Ruby Docs with annotations and searching

> 1. What purpose does YAML serve for Rannotate?

I needed some way to get the object tree that RDoc generates into a
database and YAML seems like a portable format that is easy to import
into a DB and could even be re-used by other projects.

> 2. Does Rannotate use the Ruby built-in RDoc modules to do its job?

Yes, but instead of using the normal generators (HTML, RI) that it
comes with it uses my YAML generator. I'd like to get this YAML
generator submitted to the ruby codebase even apart from my project.

> 3. Do you see the RA-Ruby site (http://ruby.outertrack.com/) as a way
> to help get more docs into the official Ruby source? That is, do you
> see the maintainer of that site gradually trying to get some of the
> more valuable "comments" into the Ruby source code files?

Yes! Definitely, but I also see it as adding searching, diffing and
other capabilities to the docs. Like this:
http://rails.outertrack.com/history/RaClass/ActionController%3A%3ABase

> 3.1. Do you see any easy way to help automate the process of
> selectively merging choice RA site comments into RDoc in the source
> code files?

I'm open to ideas!

--
Conor