[openstack-dev] [nova][docs] Concerns with docs migration

Mathieu Gagné mgagne at calavera.ca
Wed Aug 2 17:34:22 UTC 2017

On Wed, Aug 2, 2017 at 12:28 PM, Clark Boylan <cboylan at sapwetik.org> wrote:
> On Wed, Aug 2, 2017, at 07:55 AM, Matt Riedemann wrote:
>> Now that Stephen Finucane is back from enjoying his youth and
>> gallivanting all over Europe, and we talked about a few things in IRC
>> this morning on the docs migration for Nova, I wanted to dump my
>> concerns here for broader consumption.
>> 1. We know we have to fix a bunch of broken links by adding in redirects
>> [1] which sdague started here [2]. However, that apparently didn't catch
>> everything, e.g. [3], so I'm concerned we're missing other broken links.
>> Is there a way to find out?
> The infra team can generate lists of 404 urls fairly easily on the docs
> server. This won't show you everything but will show you what urls
> people are finding/using that 404.

Thanks for proposing this proactive solution.
I find it *very frustrating* to Google something and land on a 404 error.
Especially when the user survey keeps asking "How often do users refer
to documentation from docs.openstack.org?"
I don't often refer to the documentation but as of today, when I does,
it's only to find the page I'm looking for has moved somewhere.
What kind of experience are we giving to the users and operators? (I'm
sure it's with good intents and for the best)

I'm glad people are addressing the redirection issues.


More information about the OpenStack-dev mailing list