The original documentation layout for OpenStack was designed a couple of years ago. We have created a lot of documentation, and learnt much about how our various users interact with it. We now also have a new book: the OpenStack Operations Guide. Due to these issues, we should restructure the documentation for greatest effectiveness.
This should address bugs like:
https://bugs.launchpad.net/openstack-manuals/+bug/1110137 #1110137 "running openstack" guide is exhaustive to the point of being past useful