From: Eric Hodel <drbrain@...7.net>
Date: 2011-08-06T06:05:17+09:00
Subject: Re: Brainstorming ideas how to improve Ruby's documentation

On Aug 5, 2011, at 11:54 AM, Phillip Gawlowski wrote:
> On Fri, Aug 5, 2011 at 8:44 PM, Andy Davis <ananonana@gmail.com> wrote:
>>> They are a usability and accessibility nightmare.
>> 
>> Can you elaborate?  The ruby documents --RDoc and the stdlib-- are in
>> frames.  It sounds like the document masters wouldn't agree.
> 
> Browse to the Ruby standard library with a non-frames, text-only
> browser. Screen readers don't do a much better job of parsing frames.
> And consider the linking nightmare.
> 
> And the RDoc generated documentation is in frame form because that's
> how RDoc originally outputted docs.

Yup, and this is one of the reasons why RDoc hasn't shipped with a way to generate HTML frames in years.