[
https://issues.apache.org/jira/browse/CASSANDRA-14313?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16398972#comment-16398972
]
Jon Haddad commented on CASSANDRA-14313:
----------------------------------------
At this point the best thing to do is keep improving the trunk docs, to keep
the scope of work small. Ideally we'd have a solid set of docs for 4.0, and at
that point we can discuss improving the docs in branches of previous releases.
Trying to boil the ocean with 4 versions of docs isn't going to get us to world
class docs any sooner.
> Maintain a separate repository for the online documentation
> -----------------------------------------------------------
>
> Key: CASSANDRA-14313
> URL: https://issues.apache.org/jira/browse/CASSANDRA-14313
> Project: Cassandra
> Issue Type: Improvement
> Reporter: Kenneth Brotman
> Priority: Major
>
> For some reason I'm told by many committers that we should not have sets of
> documentation for other versions than the current version in a tree for that
> version. This has made it difficult, maybe impossible to have documentation
> for all the supported versions on the website at one time.
> As a solution I propose that we maintain the online documentation in a
> separate repository that is managed as the current repository under the
> guidance of the Apache Cassandra PMC (Project Management Committee); and that
> in the new repository we:
> # Maintain the code in html, css and javascript so changes can be made
> easily using any number of programs.
> # That we immediately copy the current code to a new repository, convert it
> to html, css and javascript, convert it into a multi-version form and then
> switch over to it from now on for the online documentation.
> I ask you to consider that right now there is not much on the web site. Many
> of us have the skill set to do this work in a matter of days. I can myself.
> Therefore, if this is agreeable to everyone, whether no one else helps or
> not, I will make sure its done over a two week period of time.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
