[ https://issues.apache.org/jira/browse/CASSANDRA-13907?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16210820#comment-16210820 ]
Sylvain Lebresne commented on CASSANDRA-13907: ---------------------------------------------- For what it's worth, the current code to generate the doc for the web-site already has everything need to create per-version code. The intent was to have per-version doc at {{doc/<version>}}, with {{doc/latest}} always pointing to the latest version. But this hasn't been done properly when the doc has been updated, and in fact the only version currently up is that of 4.0, which isn't even released so it's obviously completely wrong. So don't think we need much new code here, just better discipline in updating the web site ([~mshuler]: pinging you in particular since I believe you've been the one doing such updates for new release). Could be the existing scripts could be improved to make it easier though. With all this being said, I'm not 100% certain the ASF would be fine with us keeping *all* versions (and thus an always increasing number of them) online moving forward. It might be we have to stick to one doc by "major" branch, so today that would be {{doc/3.0/}} and {{doc/3.11}} with {{doc/latest}} pointing to the latter. > 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-unsubscr...@cassandra.apache.org For additional commands, e-mail: commits-h...@cassandra.apache.org