Move docs to doc.

To better facilitate the building and publishing of sphinx
documentation by Jenkins we are moving all openstack projects with
sphinx documentation to a common doc tree structure. Documentation
goes in project/doc/source and build results go in project/doc/build.

Change-Id: I925e687254bac9e06c2c520f4fc35a083e21c4ca

MANIFEST.in

@@ -1,5 +1,5 @@
 include AUTHORS
 include LICENSE
 include README.rst
-recursive-include docs *
+recursive-include doc *
 recursive-include tests *

README.rst

@@ -101,7 +101,7 @@ Building Contributor Documentation
 
 This documentation is written by contributors, for contributors.
 
-The source is maintained in the ``docs/source`` folder using
+The source is maintained in the ``doc/source`` folder using
 `reStructuredText`_ and built by `Sphinx`_
 
 .. _reStructuredText: http://docutils.sourceforge.net/rst.html
@@ -115,7 +115,7 @@ The source is maintained in the ``docs/source`` folder using
 
     $ export DJANGO_SETTINGS_MODULE=local.local_settings
     $ python doc/generate_autodoc_index.py
-    $ sphinx-build -b html docs/source build/sphinx/html
+    $ sphinx-build -b html doc/source build/sphinx/html
 
 Results are in the `build/sphinx/html` directory
 

setup.cfg

@@ -7,9 +7,9 @@ verbosity=2
 detailed-errors=1
 
 [build_sphinx]
-source-dir = docs/
+source-dir = doc/source
-build-dir = docs/_build
+build-dir = doc/build
 all_files = 1
 
 [upload_sphinx]
-upload-dir = docs/_build/html
+upload-dir = doc/build/html