Right now we have several docs to maintain, and users have several docs to sort through. My observation of the issue has been that beginners don't know what they don't know. There has to be a way of lowering the barrier to entry without rendering the docs useless for people past their first deployment. In the context of this discussion I am talking about all of the guides, but not really the content. The content we have really is not that bad. I am more interested about how that content is found and presented to the user.
Is there a facility we can use that would just scope the docs to a point of view? Maybe like a tag in sphinx?
Docs and "cloudy understanding" have been the barrier to entry in Openstack for many shops for a long time, so its a great conversation for us to be having.
~/Donny Davis