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

Reply via email to