[ 
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

Reply via email to