Revert "Revert "add deprecation notice""

This reverts commit 1fb3712509e86d5ccc2967ef1daeb197629f11e3.