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.