added deprecation explanation, warning, and migration procedure
version bump