Updated documentation

- Still several documents left to write
- Updated requirements files
- Added placeholder .ipynb examples to link in documentation
Added old->new API document

- And modified a bunch of others
Mocked out things so RTD will build

- Also removed the dependency on the Mock package,
  as we were using a very trivial subset of it.
Added docstrings, esp. for Ensemble.