cassandra-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Murukesh Mohanan (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (CASSANDRA-13907) Versioned documentation on cassandra.apache.org
Date Thu, 19 Oct 2017 12:15:00 GMT

    [ 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


Mime
View raw message