rearrange existing documentation to follow the new layout

Change-Id: I62cf076457c3c6da54402e460cf51a2c4e56037c

doc/source/conf.py

@@ -23,7 +23,7 @@ sys.path.insert(0, os.path.abspath('../..'))
 extensions = [
     'sphinx.ext.autodoc',
     #'sphinx.ext.intersphinx',
-    'oslosphinx'
+    'openstackdocstheme',
 ]
 
 # autodoc generation is a bit aggressive and a nuisance when doing heavy
@@ -57,6 +57,7 @@ pygments_style = 'sphinx'
 # html_theme_path = ["."]
 # html_theme = '_theme'
 # html_static_path = ['static']
+html_theme = 'openstackdocs'
 
 # Output file base name for HTML help builder.
 htmlhelp_basename = '%sdoc' % project

doc/source/contributor/index.rst

@@ -0,0 +1,5 @@
+
+About Sushy Tools
+=================
+
+.. include:: ../../../README.rst

doc/source/index.rst

@@ -1 +1,14 @@
-The sushy-tools uses the main Sushy documentation, you can access it at: http://sushy.readthedocs.io
+
+Welcome to Sushy Tools documentation!
+=====================================
+
+
+The sushy-tools uses the main Sushy documentation, you can access it at the
+`OpenStack Documentation <https://docs.openstack.org/sushy/>`_ site.
+
+Contents:
+
+.. toctree::
+   :maxdepth: 1
+
+   contributor/index

test-requirements.txt

@@ -7,7 +7,7 @@ hacking!=0.13.0,<0.14,>=0.12.0 # Apache-2.0
 coverage>=4.0 # Apache-2.0
 python-subunit>=0.0.18 # Apache-2.0/BSD
 sphinx>=1.5.1 # BSD
-oslosphinx>=4.7.0 # Apache-2.0
+openstackdocstheme>=1.11.0 # Apache-2.0
 oslotest>=1.10.0 # Apache-2.0
 testrepository>=0.0.18  # Apache-2.0/BSD
 testscenarios>=0.4  # Apache-2.0/BSD