Old ironic-install documentation page should be deleted

Bug #1323712 reported by Ruby Loo
10
This bug affects 2 people
Affects Status Importance Assigned to Milestone
Ironic
Fix Released
Low
Anne Gentle

Bug Description

This install page: http://docs.openstack.org/developer/ironic/install/ironic-install.html is old. It was moved to http://docs.openstack.org/developer/ironic/deploy/install-guide.html.

We should delete the old page, so as to avoid confusion.

UPD: one more such page to delete: http://docs.openstack.org/developer/ironic/dev/api-spec-v1.html

Also note that these pages are absent from our source, they are left somewhere on the docs server.

Revision history for this message
Dmitry Tantsur (divius) wrote :

Hi! I don't see the old page anymore, link in description gives 404, so I assume that was fixed

Revision history for this message
Dmitry Tantsur (divius) wrote :

Ah, sorry, wrong link in description

description: updated
summary: - old ironic-install documentation page
+ Old ironic-install documentation page should be deleted
Changed in ironic:
status: New → Triaged
importance: Undecided → High
tags: added: low-hanging-fruit
Revision history for this message
aeva black (tenbrae) wrote :

changing to Low -- while important, it's not severe and impacting use of the code.

Changed in ironic:
importance: High → Low
Dmitry Tantsur (divius)
description: updated
description: updated
tags: removed: low-hanging-fruit
Revision history for this message
Steven Hardy (shardy) wrote :

Apparently also old API documentation, e.g:

http://docs.openstack.org/developer/ironic/dev/api-spec-v1.html#image

which is an API that doesn't exist, apparently that whole page has been replaced by:

http://docs.openstack.org/developer/ironic/webapi/v1.html

(thanks to folks on IRC for pointing me at that)

FWIW having stale docs which look current on the official http://docs.openstack.org/ site (as opposed to the wiki, where you expect bit-rot) is not really that low priority - it's really confusing for new users, e.g I just developed a whole set of heat resources for Ironic against old API docs...

Revision history for this message
Anne Gentle (annegentle) wrote :

I can handle this but it has to be manual. Two questions:
- Should I delete the install directory?
- Do you have a means to do a redirect?

Changed in ironic:
assignee: nobody → Anne Gentle (annegentle)
Revision history for this message
Dmitry Tantsur (divius) wrote :

Anne, thank you for looking into this.
- Seems like yes
- Actually I don't know :(

Revision history for this message
Andreas Jaeger (jaegerandi) wrote :

Is a redirect needed? IF yes, from where to where?

Revision history for this message
Anne Gentle (annegentle) wrote :
Revision history for this message
Anne Gentle (annegentle) wrote :

Why didn't this change to the .htaccess fix this bug? https://review.openstack.org/#/c/113633/1/www/.htaccess

Revision history for this message
Jim Rollenhagen (jim-rollenhagen) wrote :

Should have been fixed in https://review.openstack.org/#/c/113633

Turns out the URL is wrong, pushing another patch shortly.

Revision history for this message
Jim Rollenhagen (jim-rollenhagen) wrote :

Should be fixed when https://review.openstack.org/#/c/116939/ lands.

Revision history for this message
Jim Rollenhagen (jim-rollenhagen) wrote :

116939 landed, redirect seems to work.

Changed in ironic:
status: Triaged → Fix Committed
status: Fix Committed → Fix Released
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/openstack-manuals 15.0.0

This issue was fixed in the openstack/openstack-manuals 15.0.0 release.

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.