Chris Riccomini created SAMZA-259:
-------------------------------------
Summary: Restructure documentation folders
Key: SAMZA-259
URL: https://issues.apache.org/jira/browse/SAMZA-259
Project: Samza
Issue Type: Bug
Components: docs
Affects Versions: 0.6.0
Reporter: Chris Riccomini
Currently, we have hard-coded versions in the documentation path. When we bump
versions we have to manually create a new subfolder called 0.8.0, and update
all links to point to this version. A better approach is probably do what
[rust|http://www.rust-lang.org/] does: use branches to build multiple versions
of documentation. We already have an 0.7.0 branch, and we've got master. This
very much mirrors Rust's structure:
http://static.rust-lang.org/doc/master/tutorial.html
http://static.rust-lang.org/doc/0.10/tutorial.html
This structure shouldn't change the paths in the website. All that it means is
that we'll have:
* http://samza.incubator.apache.org/startup/hello-samza/master/
* http://samza.incubator.apache.org/startup/hello-samza/0.7.0/
* http://samza.incubator.apache.org/learn/documentation/master/
* http://samza.incubator.apache.org/learn/documentation/0.7.0/
* http://samza.incubator.apache.org/learn/tutorials/master/
* http://samza.incubator.apache.org/learn/tutorials/0.7.0/
As the defaults. This is better for SEO, as well, since everyone will link to
master, which will always reflect up-to-date information. With our current
setup, everything that links to 0.7.0 will be outdated when we release docs
with 0.8.0.
--
This message was sent by Atlassian JIRA
(v6.2#6252)
