Details
-
Improvement
-
Status: Resolved
-
Normal
-
Resolution: Abandoned
-
None
-
None
-
None
Description
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.