You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cassandra.apache.org by "Kenneth Brotman (JIRA)" <ji...@apache.org> on 2018/03/14 16:19:00 UTC

[jira] [Created] (CASSANDRA-14313) Maintain a separate repository for the online documentation

Kenneth Brotman created CASSANDRA-14313:
-------------------------------------------

             Summary: 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


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 right now.  Many of us have the skill set to do this work in a matter a 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-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org