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:24:00 UTC
[jira] [Updated] (CASSANDRA-14313) Maintain a separate repository
for the online documentation
[ https://issues.apache.org/jira/browse/CASSANDRA-14313?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kenneth Brotman updated CASSANDRA-14313:
----------------------------------------
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.
was:
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 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.
> 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-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org