From: Andy Davis <ananonana@...>
Date: 2011-08-06T03:44:51+09:00
Subject: Re: Brainstorming ideas how to improve Ruby's documentation

> 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.

Personally speaking, I've yet to find any documentation as well packaged
and accessible as the javadocs.  Ruby docs aren't bad, but my preference
is the javadoc style.

> There's a reason the
> W3C recommends *against* using frames (in fact, HMTL5 was supposed to
> remove frames altogether).

What reason would that be?  I tend to agree that web sites that use
frames tend to be a bit ugly and difficult to use.  But this pertains to
documentation, where the divide and conquer approach is very helpful.
Frames do serve a purpose, but maybe not for you.

-- 
Posted via http://www.ruby-forum.com/.