OpenStack: fix instructions and move to docs site

This PR builds upon the great work by @paulczar in #2604. I cleaned up these docs a bit based on the review in that PR, and moved them to the docs site to be similar to the rest of our provider documentation.

replaces #2604
needs 4 spaces for indentation