Add python API to doc

Update the documentation to include a generated python
module index detailing the python API for the project.

Change-Id: I3a0b54ca96f95ec84c17348f3821250fb630b842

.gitignore

@@ -45,6 +45,7 @@ output/*/index.html
 
 # Sphinx
 doc/build
+doc/source/reference/api
 
 # pbr generates these
 AUTHORS

README.rst

@@ -10,6 +10,6 @@ node composition and decomposition, remote storage discovery and composition,
 and NVMe over PCIe drive attaching and detaching to logical nodes.
 
 * Free software: Apache license
-* Documentation: http://docs.openstack.org/developer/rsd-lib
+* Documentation: http://docs.openstack.org/rsd-lib/latest
 * Source: http://git.openstack.org/cgit/openstack/rsd-lib
 * Bugs: http://bugs.launchpad.net/https://launchpad.net/python-rsdclient

doc/source/reference/index.rst

@@ -1,10 +1,32 @@
-==========
-References
-==========
+======================
+RSD Library References
+======================
 
-References of rsd-lib.
+Features
+========
+
+* Existing sushy library functionality abstracting system
+  resources
+* Enablement of node composition services via Rack Scale Design
+  enabled hardware.
+* Abstraction of composed node, remote storage, and NVMe device
+  resources, including identification and asset information.
+* Composed node power management.
+* Changing nodes boot device, frequency, and mode.
+* Attaching/Detaching of NVMe devices to existing composed nodes.
 
 .. toctree::
    :maxdepth: 2
 
    usage
+
+RSD-Lib Python API Reference
+============================
+
+* :ref:`modindex`
+
+.. # api/autoindex is hidden since it's in the modindex link above.
+.. toctree::
+  :hidden:
+
+  api/autoindex

setup.cfg

@@ -45,3 +45,9 @@ input_file = rsd_lib/locale/rsd_lib.pot
 keywords = _ gettext ngettext l_ lazy_gettext
 mapping_file = babel.cfg
 output_file = rsd_lib/locale/rsd_lib.pot
+
+[pbr]
+autodoc_index_modules = True
+api_doc_dir = reference/api
+autodoc_exclude_modules =
+    rsd_lib.tests.*