Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clean up 'installing' page #917

Open
rbowen opened this issue Jun 6, 2017 · 9 comments
Open

Clean up 'installing' page #917

rbowen opened this issue Jun 6, 2017 · 9 comments
Assignees

Comments

@rbowen
Copy link
Contributor

rbowen commented Jun 6, 2017

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
Copy link
Member

pmkovar commented Jun 8, 2017

@rbowen What content there would you suggest for removal?

@rbowen
Copy link
Contributor Author

rbowen commented Jun 9, 2017

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
Copy link
Contributor

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.

@pmkovar pmkovar self-assigned this Jul 14, 2017
@snecklifter
Copy link
Contributor

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
Copy link
Member

pmkovar commented Jul 24, 2017

@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
Copy link
Contributor

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
Copy link
Contributor

@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
Copy link
Contributor

@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
Copy link
Contributor

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants