Expand documentation

[exTerEX]

The sphinx documentation needs expansion. Needs to include allowed values, etc. in documentation.rst, and examples of how to use the code. A minimum of one simple example in index.rst and potentially a few more intermediate to advanced uses in examples.rst.