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 10:25:00 GMT

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

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

Having all versions would be impractical (I think the services which do per-commit docs generate
them on-demand, but I'm not sure). Since {{make html}} only worked for 5 tags, I just added
them all to my site.

How about something like the Debian system: old-stable (2.X), stable (3.0), latest (3.11),
and trunk (rolling, updated regularly, maybe once a week)? If links like {{/stable}}, {{/latest}}
can be provided, it would be even more convenient.

Is there something I can do to help with this? Are the scripts for the website open?

> 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