Make sphinx compileable

Actually testing things is probably pretty important

{{cookiecutter.repo_name}}/CONTRIBUTING.rst

@@ -1,3 +1,7 @@
+=============================================
+Contributing to: {{ cookiecutter.repo_name }}
+=============================================
+
 If you would like to contribute to the development of OpenStack,
 you must follow the steps in the "If you're a developer, start here"
 section of this page:

{{cookiecutter.repo_name}}/doc/source/conf.py

@@ -23,7 +23,7 @@ sys.path.insert(0, os.path.abspath('../..'))
 extensions = [
     'sphinx.ext.autodoc',
     #'sphinx.ext.intersphinx',
-    'oslo.sphinx'
+    'oslosphinx'
 ]
 
 # autodoc generation is a bit aggressive and a nuisance when doing heavy

{{cookiecutter.repo_name}}/doc/source/contributing.rst

@@ -1 +0,0 @@
-.. include:: ../../CONTRIBUTING.rst

{{cookiecutter.repo_name}}/doc/source/contributing.rst

@@ -0,0 +1 @@
+../../CONTRIBUTING.rst

{{cookiecutter.repo_name}}/doc/source/index.rst

@@ -18,9 +18,10 @@
 
 .. toctree::
    :maxdepth: 2
-   readme <readme>
+
-   contributing <contributing>
+   README <readme>
-   Sample Template <template.rst>
+   contributing
+   Sample Template <template>
 
 
 Indices and tables

{{cookiecutter.repo_name}}/doc/source/readme.rst

@@ -1 +0,0 @@
-.. include:: ../README.rst

{{cookiecutter.repo_name}}/doc/source/readme.rst

@@ -0,0 +1 @@
+../../README.rst

{{cookiecutter.repo_name}}/doc/source/template.rst

@@ -1 +0,0 @@
-.. include:: ../template.rst

{{cookiecutter.repo_name}}/doc/source/template.rst

@@ -0,0 +1 @@
+../../template.rst