A discussion was held in the OpenStack manuals social track at the Barcelona summit and we agreed to start including deployment projects, with appropriate installation guide(s), into the docs.o.ohttp://docs.openstack.org/ site. Similar to what we have done with the Installation Tutorials.
After working heavily with the OpenStack-Ansible team over the last few cycles, I have worked to ensure their Installation Guide is of the same standard as our manuals docs – following the Contributor guide and OpenStack manuals formatting – and have proposed their guide as the guinea pig for this transition.
At the moment, we are working on the best way to publish. Experimenting with the OpenStack-Ansible guide, we have the following patches in motion:
· https://review.openstack.org/391499 (Deployment gate jobs)
· https://review.openstack.org/391486 (Putting the OpenStack-Ansible guide into the manuals cookie cutter)
All deployment projects will have the opportunity to include their individual installation guides – to be called, “Deployment Guides” (this is open for discussion if others have better ideas).
If anyone is able to help with getting these patches merged to forge an easy pathway for other deployment guides, that would be amazing. I am looking to get some help in identifying what is the best path to publish to, and help with the index files.
If any of the deployment projects are interested in getting involved, let us know and we can work together to make this transition ☺
Information Developer II
Rackspace Private Cloud Powered By OpenStack
London, United Kingdom
OpenStack Development Mailing List (not for usage questions)