Re: Documentation roadmap?

Dave Howell <[email protected]> Mon, 28 Aug 2006 10:31:57 -0700
Newsgroups gmane.comp.lang.ruby.documentation
Message-ID <[email protected]>
On Aug 25, 2006, at 22:29, Mat Schaffer wrote:

> Guess coloring the stdlib docs might not be a great idea then.  What 
> about some sort of easy configuration?  So the users that liked it 
> could get it but not all users were forced.  If we can't count on 
> server-side scripts, seems like javascript cookies would do.

Server-side scripts? Cookies? Are we talking about syntax-color-coding 
a user's locally generated HTML-based (or maybe ri-based with terminal 
ANSI codes) RDoc-generated documentation, or color-coding the 
documentation hosted at ruby-doc.org?

The former would (should?) be a matter of picking a non-default 
template when generating the documentation. The latter...well, although 
I'm definitely pro-color-coding, I don't think it's a good idea for the 
ruby-doc archives.  Colored source that uses a different scheme than 
the one I'm used to can be worse than none at all.