How should we deprecate methods?

[schloerke]

Is this a behavior we want to override?

There does appear to be some churn in how silent these are: https://docs.python.org/3/library/warnings.html#default-warning-filter but it smells a bit funny to me to wrap around core language functionality / expectations. Not saying we absolutely shouldn't but this might be a larger conversation than this PR?

Originally posted by @jonkeane in #339 (comment)

[schloerke]

Closing as deprecations should not be handed right now.

Instead the method should just be replaced.

Related: #339 (comment)