Clean up 'installing' page
Opened this issue · 9 comments
The Installing page - https://www.rdoproject.org/install/ - is getting out of hand. It has a number of dead links, as well as a lot of stuff that has very little to do with installing.
I'm just not a fan of these pages that are huge list of links. I would rather give some direction to the beginner, than just the multiple choice "pick one of these million links". In particular, I think we should be encouraging the use of TripleO, and then we should be walking the user through a path to a goal.
Plus there's some stuff here, like the cloud management stuff, that feels out of place on an install page.
Finally, the intro paragraph is not what we want our message to be, if we are encouraging TripleO as Plan A.
I vote in favour of removal - I'm not sure this is adding anything that isn't explain in brief on the main page or any of the pages heading off that.
I've removed some stuff that isn't RDO-specific. I'm not sure we need the ManageIQ section - more duplication of content, I think something like a page with "taking openstack further" a links to things like openshift on openstack, manageIQ etc.
Thoughts?
@snecklifter It really looks like we should link to ManageIQ from somewhere else than the install section. I think the ManageIQ page itself can stay but needs to be moved to /use probably? It pretty much just explains what RDO+ManageIQ is for and provides a few useful links.
Anything specific still needs to be done in this? the latest page https://www.rdoproject.org/install/ looks fine as per outline, though some of the linked pages may need an update.
@karelyatin I honestly think that the entire website should be removed and just point to the tripleo documentation upstream. Its a confusing mess of out of date content, talks about packstack then tripleo-qs then tripleo. Links to random images of hardware. An empty events page. Its completely uninspiring.
@snecklifter sure we are working on new contribution guidelines and cleanup of outdated items and will consider all your mentioned points, the idea here was to provide some options which users can try out including tripleo, packstack, tripleo-quickstart. But i agree and understand we need to improve here.
@karelyatin look forward to it and happy to help if there is a concerted will to address it. Last time it got bogged down in conversations about choice vs simplicity. A good example is that this website not only mentions packstack and tripleo but also packstack quickstart and tripleo-quickstart. OpenStack is complex enough, personally I'd vote for removal of all packstack references since there is now an tripleo AIO deployment method. Packstack doesn't build any tripleo skills so I dont see the point.