From: Markus Fischer <markus@...>
Date: 2011-08-03T05:59:30+09:00
Subject: Re: Documentation Improvement Proposal

On 02.08.2011 18:36, Chris White wrote:
> * Establish a content management system / wiki which will allow for:

The only objection I've is that I'm not sure if it is really suited well
for multiple versions of Ruby. I.e. the docs written would have to be
associated for a specific version otherwise things can become very
confusing. If you look at http://www.ruby-doc.org/ you see multiple
standard libraries referenced by their version number.

I'd be interesting how to solve this with a typical cms/wiki software.
Basically, the documentation would have to tied to a specific ruby
version and naturally migrate with it's evolution (i.e. new relases, etc.).

What I want to say: if you have the new doc system as source files (XML,
rdoc, whatever), you naturally version them and can branch them and thus
it's possible to have this documentation <> ruby version link; you even
can backport documentation improvements and such. I'm unsure if that
would be possible with a classical online CMS/wiki.

sincerely,
- Markus