Mailing-List: contact commits-help@cassandra.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cassandra.apache.org
Date: Thu, 19 Oct 2017 12:15:00 +0000 (UTC)
From: "Murukesh Mohanan (JIRA)" <jira@apache.org>
To: commits@cassandra.apache.org
Message-ID: <JIRA.13105280.1506474552000.7390.1508415300134@Atlassian.JIRA>
In-Reply-To: <JIRA.13105280.1506474552000@Atlassian.JIRA>
References: <JIRA.13105280.1506474552000@Atlassian.JIRA> <JIRA.13105280.1506474552104@jira-lw-us.apache.org>
Subject: [jira] [Commented] (CASSANDRA-13907) Versioned documentation on
 cassandra.apache.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
archived-at: Thu, 19 Oct 2017 12:15:04 -0000


    [ https://issues.apache.org/jira/browse/CASSANDRA-13907?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16210929#comment-16210929 ] 

Murukesh Mohanan commented on CASSANDRA-13907:
----------------------------------------------

Nothing further on labeling the versions from me, then. I'd rather have multiple versions supported than bicker about what to call them.

Thanks for the link to the source. Reading the README, I can appreciate why Michael might generate just the trunk and leave it alone. Integrating Jekyll with a non-Jekyll source is a PITA. Having a consistent theme and structure to the docs and the main Cassandra site is important, and that's probably why this devolved to the way it is now.

As it always does, it looks like this will take more effort than I originally thought it would. :) In the meantime, I'll try to set it up so that the POC is automatically updated so that versioned docs are available somewhere.

> Versioned documentation on cassandra.apache.org
> -----------------------------------------------
>
>                 Key: CASSANDRA-13907
>                 URL: https://issues.apache.org/jira/browse/CASSANDRA-13907
>             Project: Cassandra
>          Issue Type: Improvement
>          Components: Documentation and Website
>            Reporter: Murukesh Mohanan
>            Priority: Minor
>
> Services like https://readthedocs.org and http://www.javadoc.io/ make it easy to browse the documentation for a particular version or commit of various open source projects. It would be nice to be able to browse the docs for a particular release on http://cassandra.apache.org/doc/.
> Currently it seems only CQL has this at http://cassandra.apache.org/doc/old/.


--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org