Deprecation

Documentation changes to prepare v2.0
Good catch!