Class name changes & Documentation

- improved documentation and examples
- Added deprecation warnings when using old class names
added missing file
documentation tweaks / coveragerc