Documentation update

Clarifed some things, included warnings for pending deprecations.
Version Bump - 0.8.3