[DOCS-6703] Docs should point to correct version number

[aitseitz]

Hi,

I've posted this documention suggestion on the official alfresco discord server and as told by @aborroy I'm therefore opening this ticket:

---

In my acs ansible tasks or in other source code I'm writing for the customer, I'm always referencing to the official documentation pages.
For example, for an ACS 6.2 ansible task, I'm referencing to
https://docs.alfresco.com/content-services/6.2/install/zip/tomcat/#install-alfresco-wars

For the current ACS 7.2 version I can only reference to:
https://docs.alfresco.com/content-services/latest/install/zip/tomcat/#install-alfresco-wars

What I would like to reference in my sourcecode is:
https://docs.alfresco.com/content-services/7.2/install/zip/tomcat/#install-alfresco-wars
so I don't have to adjust my commits once the next ACS version 7.3 is out...

This Issue is not only related to ACS, it's a general topic for all alfresco services documentations.
Is it somehow possible to upload/reference the latest documentation as well for the specific version number?

I've also realized alfresco itself runs into this issue with all it's release notes!

For Example:
Release Notes form ACS 7.1 sadly does not point to its correct documentation:
https://docs.alfresco.com/content-services/7.1/

Release Notes from ACS 7.0 sadly does not point to its correct documentation:
https://docs.alfresco.com/content-services/7.0/

and so on....

[aitseitz]

@anxumalo @aborroy
I opened the discord topic for the case with this pullrequest
#618

The commit is more a dummy commit to open the topic. You have to evaluate it internally and how you want handle this now and in the near future, as well as in regards of the upcomming acs naming sheme. I can't fix it for you, cause there is more to the topic then just provide a 7.2 copy from the latest docs....SEO and SEM must be evaluated as well, so that new and old documentations does never link to a 404 page.

One Solution could be done via Proxy settings so that
https://docs.alfresco.com/content-services/latest/
always redirects to the latest acs version, which currently is
https://docs.alfresco.com/content-services/7.2/

[anxumalo]

Thanks for your feedback and for your patience. We really appreciate the time that you have taken to let us know what you think.

We've taken note of your suggestions and will discuss the required changes with the relevant teams. As you can appreciate, it's not an easy fix and may take some time. This is tracked internally as DOCS-6703.

[anxumalo]

Hi @aitseitz, there have been some related updates applied to the Alfresco Docs site. Although this work doesn't fully address the issue you reported (i.e. provide Docs that point to the exact version number), we’ve implemented redirects that reduce the number of Docs links that result in 404 pages from our software, for example, from the Admin Console.

If you find any links that may have been missed, please feel free to report them in a new PR. Many thanks