[OpenStack-docs] [openstack-docs] Archiving documentation

Tom Fifield tom at openstack.org
Tue Jan 24 13:22:46 UTC 2017


On 24/01/17 20:53, Andreas Jaeger wrote:
> On 2017-01-24 13:48, Tom Fifield  wrote:
>> On 24/01/17 20:47, Andreas Jaeger wrote:
>>> On 2017-01-24 13:44, Tom Fifield  wrote:
>>>> Top posting with intent :)
>>>>
>>>> We have someone who is representing a class of people that are almost
>>>> certainly more than 5% of our users and we chose not to help? No two
>>>> ways about it - with the minimal/once-off effort involved, that is just
>>>> plain wrong.
>>>>
>>>> To fix Icehouse docs not existing, all one would need to do is copy from
>>>> the old server to the new. We broke this, and we should fix it.
>>>
>>> And the fix is a redirect like we did for all previous releases.
>>
>> Except that isn't a fix - see the comments from your users :)
>
> Tom,
>
> we retired Icehouse in April 2016 already. And even before that there
> was no way to go from docs.o.o/index.html to any Icehouse content.
>
> This is the first report of an Icehouse user - that somehow had old
> bookmarks or whatever obsolete link that pointed to an Icehouse
> Configuration reference page,

The thing is - the Icehouse (or Juno, or Kilo, or Liberty) configuration 
reference is not 'old' or 'obsolete' for these users. It's an integral 
document to keep their cloud running, or prepare for their upgrade to a 
newer version. It's entirely valid for them to bookmark a link, or 
follow an Ask OpenStack posting that sends them to a useful page.


The OpenStack docs team is not in the position to make the decision 
about when a cloud is online, offline, ready for upgrade, insecure, 
unstable or obsolete. It exists to serve the users who are in that 
position. As such, content must remain until when our users no longer 
need it. It's surprising to see how much resistance there is to this 
idea, given it takes very minimal effort to keep an existing HTML page 
online :) Our best data on users indicates that we no longer need 
Austin, Bexar, Cactus or Diablo, but there are still significant numbers 
on Icehouse and later.

So, why not help Alvaro? Martin? Cristina? Randy? Mikhail? Renato? 
Christian? Tomo? Graeme? Vaibhav? These are just a few of the people 
running Icehouse that need this doc to do their job. How about it?



More information about the OpenStack-docs mailing list