On 03/13/2017 04:07 PM, Clebert Suconic wrote:
Sure. Latest 1.x and latest 2.x.
Just that it seems too much now.
Isn't that just two instances? That doesn't seem like to much.
On Mon, Mar 13, 2017 at 1:42 PM Jiri Danek <[email protected]> wrote:
On Mon, Mar 13, 2017 at 6:27 PM, Clebert Suconic <
[email protected]>
wrote:
I was wondering if we could / should update the docs page to only
include the latest version (that is 2.0.0)... The docs are still
maintained at the git, so you can always refer to the doc of the
version you're using when you download.. or you can use links from
github.
It seems strange to maintain the 1.x release stream and not have
documentation for it on the site. There should be at least the latest 1,x
and the latest 2.0 version.
The projects whose documentation I often browse online all have previous
doc versions on the site, be it https://www.postgresql.org/docs/, Python
or
readthedocs.io hosted sites like http://docs.pachyderm.io/en/stable/ (see
the version picker at the bottom left).
readthedocs.io sites also have a noticebar that alerts users that they are
browsing documentation for older release; I once raised this as feature
request https://issues.apache.org/jira/browse/ARTEMIS-615
That would also make it easier for web robots (google, etc) to index it.
<link href="http://www.example.com/canonical-version-of-page/";
rel="canonical" />
in the HTML head section should take care of that. This is what
readthedocs.io does.
--
Jiří Daněk
Messaging QA
--
Tim Bish
twitter: @tabish121
blog: http://timbish.blogspot.com/
