Use stable version URLs for documentation
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
openstackdocstheme |
In Progress
|
Critical
|
Alexandra Settle |
Bug Description
This issue has been split from Bug #1479166 to capture the request of Martin Paulo in comment #3
---
As a developer the OpenStack documentation can be very frustrating. Let me try to explain...
Faced with a problem, I turn to Google, which gives me links that look as though they might help me. Say one is to a blog posting, or to Stack Overflow. This article provides good information, but contain links to the OpenStack documentation for more detail. So I click on the link, only to find that the page no longer exists.
So I turn to Google again, trying to find this new information. But Google itself either contains links that are either outdated (so I have to go the cache, not always guaranteed to work) or that take me to pages that exist: but turn out to be part of some older documentation set (I haven't experienced this for a while, so don't know if this is fixed or not). Clicking around the older documentation set results in total confusion as you get launched into new parts of the site. And you don't find what you are looking for...
Could you please migrate the documentation to stable urls (as per http://
This would have the added advantage of allowing people who are on older versions of OpenStack to still have easy access to the relevant documentation.
Thank you!
description: | updated |
Changed in openstack-manuals: | |
status: | New → Triaged |
Changed in openstack-manuals: | |
assignee: | nobody → Alexandra Settle (alexandra-settle) |
tags: | added: doc-tools |
affects: | openstack-manuals → openstack-doc-tools |
From what I can see, we have stable URLs:
http:// docs.openstack. org/liberty/ docs.openstack. org/mitaka/
vs
http://
http:// docs.openstack. org/liberty/ install- guide-ubuntu/ docs.openstack. org/mitaka/ install- guide-ubuntu/
vs
http://
The addition of watermarks to versioned books should help with some of the problems that arise from linking into the docs from other sources.
I think this is still a problem though: "clicking around the older documentation set results in total confusion as you get launched into new parts of the site."
In other words, if you select 'Liberty' in the 'More Releases & Languages' dropdown, you are taken to the http:// docs.openstack. org/liberty/ index page. So far so good.
If you click 'Administrator Guide' you are taken to http:// docs.openstack. org/admin- guide/. This is correct, as the Administrator Guide is not versioned.
However, if you now use the 'OpenStack Documentation' dropdown to select 'Install Guides', you are taken to http:// docs.openstack. org/index. html#install- guides. This is not expected as the user originally selected 'Liberty' and expects to arrive at the Liberty Install Guide.