Add main developer page

This adds the main ('index') page for developers (to be available
at http://docs.openstack.org/developer/python-ironicclient/).
It has minimal information, and is a place holder so that we can
start adding documentation.

This also fixes issues with 'python setup.py build_sphinx':
- was getting "error: 'source_dir' must be a directory name"
  because sphinx 1.2b3 was being installed instead of 1.1.2
  (see https://bugs.launchpad.net/openstack-ci/+bug/1259511)
- was getting "sphinx.errors.ExtensionError: Could not import
  extension oslo.sphinx (exception: No module named sphinx)"
- was complaining about missing '_theme' (oslosphinx has the theme)

Change-Id: I47ad7e10c20b80a99ae36755b2f7f67c080676fd
Partial-Bug: #1300990

doc/source/conf.py

@@ -8,7 +8,7 @@
 extensions = ['sphinx.ext.autodoc',
               'sphinx.ext.intersphinx',
               'sphinx.ext.viewcode',
-              'oslo.sphinx'
+              'oslosphinx',
               ]
 
 # autodoc generation is a bit aggressive and a nuisance when doing heavy
@@ -45,9 +45,9 @@ pygments_style = 'sphinx'
 
 # The theme to use for HTML and HTML Help pages. Major themes that come with
 # Sphinx are currently 'default' and 'sphinxdoc'.
-html_theme_path = ["."]
-html_theme = '_theme'
-html_static_path = ['_static']
+#html_theme_path = ["."]
+#html_theme = '_theme'
+#html_static_path = ['_static']
 
 # Output file base name for HTML help builder.
 htmlhelp_basename = '%sdoc' % project

doc/source/index.rst

@@ -0,0 +1,24 @@
+===========================================
+Python Bindings to the OpenStack Ironic API
+===========================================
+
+This is a client for OpenStack `Ironic`_ API. There's a Python API
+(the `ironicclient` modules), and a command-line script (installed as
+`ironic`).
+
+Contents
+========
+
+.. toctree::
+   :maxdepth: 1
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
+
+
+.. _Ironic: https://wiki.openstack.org/wiki/Ironic

test-requirements.txt

@@ -4,6 +4,7 @@ discover
 fixtures>=0.3.14
 hacking>=0.8.0,<0.9
 mock>=1.0
+oslosphinx
 python-subunit>=0.0.18
 sphinx>=1.1.2,<1.2
 testrepository>=0.0.18

tox.ini

@@ -5,6 +5,7 @@ skipsdist = True
 
 [testenv]
 setenv = VIRTUAL_ENV={envdir}
+install_command = pip install -U {opts} {packages}
 deps =
     -r{toxinidir}/requirements.txt
     -r{toxinidir}/test-requirements.txt