[
https://issues.apache.org/jira/browse/CASSANDRA-13907?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16211161#comment-16211161
]
Michael Shuler commented on CASSANDRA-13907:
--------------------------------------------
I just wish to pass along my experiences with updating the website for the last
year or so.
- the smallest of edits (ie. new version number) generally end up with
sometimes very large unrelated HTML diff
- jekyll versions matter, which is being worked on and has had some notes added
to the README
- even with the "correct" jekyll version, building on different OS results in
different HTML tags
- some component of the build process doesn't seem understand existing
files/dirs
- code blocks are not copy & paste friendly, and I end up hand editing HTML to
remove line numbers
- many times I use the build to see what will be changed when markdown files
are updated (along with massive unintended changes), revert everything, then
hand edit
{noformat}
svn revert --recursive .
svn revert --recursive .
svn revert publish/.htaccess
svn revert --recursive publish/doc/cql3
svn revert publish/community/index.html
svn revert publish/download/index.html
svn revert --recursive .
svn revert --recursive .
svn revert --recursive ../
svn revert --recursive .
svn revert --recursive .
svn revert --recursive .
svn revert --recursive .
svn revert --recursive .
svn revert --recursive ../
svn revert --recursive ../
svn revert --recursive publish/doc/3.7
svn revert --recursive publish/doc/cql3
svn revert --recursive publish/.htaccess
svn revert --recursive .
svn revert --recursive publish/doc/3.7
svn revert publish/.htaccess
svn revert --recursive publish/doc/cql3
svn revert --recursive publish/doc/3.7
svn revert publish/.htaccess
svn revert --recursive publish/doc/cql3
svn revert --recursive .
svn revert --recursive publish/doc/3.7
svn revert publish/.htaccess
svn revert --recursive publish/doc/cql3
svn revert --recursive ../
svn revert --recursive publish/.htaccess
svn revert --recursive publish/doc/3.7
svn revert --recursive publish/doc/cql3
svn revert --recursive publish/.htaccess publish/doc/3.7 publish/doc/cql3
svn revert --recursive publish/.htaccess publish/doc/3.7 publish/doc/cql3
svn revert --recursive .
svn revert --recursive publish/.htaccess publish/doc/3.7 publish/doc/cql3
svn revert --recursive .
svn revert --recursive .
svn revert --recursive publish/.htaccess publish/doc/3.7 publish/doc/cql3
svn revert --recursive publish/.htaccess publish/doc/cql3
svn revert --recursive publish/
svn revert --recursive publish/
svn revert --recursive src/doc/
svn revert --recursive publish/.htaccess publish/doc/3.7 publish/doc/cql3
svn revert publish/index.html
svn revert publish/community/index.html
svn revert --recursive publish/.htaccess publish/doc/3.7 publish/doc/cql3
svn revert publish/community/index.html
svn revert publish/index.html
svn revert --recursive publish/.htaccess publish/doc/3.7 publish/doc/cql3
svn revert publish/community/index.html
svn revert publish/index.html
svn revert --recursive publish/.htaccess publish/doc/3.7 publish/doc/cql3
svn revert publish/community/index.html
svn revert publish/index.html
svn revert --recursive publish/.htaccess publish/doc/3.7 publish/doc/cql3
svn revert publish/community/index.html
svn revert publish/index.html
svn revert --recursive .
svn revert --recursive publish/doc/cql3 publish/.htaccess
svn revert --recursive site/
svn revert --recursive publish/.htaccess publish/doc/cql3 publish/doc/3.7
svn revert --recursive .
svn revert --recursive .
svn revert --recursive .
svn revert --recursive .
svn revert --recursive .
svn revert --recursive publish/.htaccess publish/doc/cql3 publish/doc/3.7
svn revert publish/community/index.html publish/download/index.html
svn revert --recursive .
svn revert --recursive .
svn revert --recursive .
svn revert --recursive publish/.htaccess publish/doc/cql3
svn revert publish/community/index.html
svn revert publish/.htaccess
svn revert --recursive publish/doc/cql3
svn revert publish/.htaccess publish/doc/cql3
svn revert --recursive publish/.htaccess publish/doc/cql3
svn revert src/download.md publish/download/index.html
svn revert --recursive publish/.htaccess publish/doc/cql3
svn revert --recursive publish/.htaccess publish/doc/cql3
svn revert --recursive publish/.htaccess publish/doc/cql3
svn revert --recursive publish/.htaccess publish/doc/cql3
{noformat}
> 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
