Comment 4 for bug 1220407

Diane, I like the idea - and propose to evaluate two more topics on top of it while we're doing major surgery.

I don't know the history of how docs came together but diving into the project, I had two additional structure issues:

First, why do we have doc/src/docbkx where doc and src have only a single directory? Can't we flatten this directly from doc/src/docbokx to doc?

Second, we have some guides that have a src subdirectory - and others have none. I propose to remove the current src subdirectories and move everything one level up. So, move openstack-user/src/* to openstack-user/