added improvements that i needed to take to make sphinx and a src dir…

MANIFEST.in

@@ -1 +1,4 @@
 include LICENSE
+# include following to manage src files more directly
+# adapt tests/context loader if you intend usage by adding 'src' to the path
+# recursive-include src/ *.py

README.rst

@@ -8,3 +8,16 @@ This simple project is an example repo for Python projects.
 ---------------
 
 If you want to learn more about ``setup.py`` files, check out `this repository <https://github.com/kennethreitz/setup.py>`_.
+
+---------------
+
+
+if you want to create py-modindex shpinx needs to create some files matching your code.::
+
+
+   sphinx-apidoc -o ./docs sample
+   or
+   sphinx-apidoc -o ./docs src/*
+
+
+

docs/conf.py

@@ -25,7 +25,7 @@
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = []
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.todo', 'sphinx.ext.viewcode']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

docs/index.rst

@@ -11,6 +11,7 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
+   modules
 
 
 Indices and tables