search

redhat-openstack / website

RDO Project Website
http://www.rdoproject.org
Other
46 stars 177 forks source link

Clean up 'installing' page #917

Open rbowen opened 7 years ago

rbowen commented 7 years ago

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.

pmkovar commented 7 years ago

@rbowen What content there would you suggest for removal?

rbowen commented 7 years ago

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.

snecklifter commented 7 years ago

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.

snecklifter commented 7 years ago

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?

pmkovar commented 7 years ago

@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.

karelyatin commented 3 years ago

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.

snecklifter commented 3 years ago

@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.

karelyatin commented 3 years ago

@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.

snecklifter commented 3 years ago

@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.