@david used deprecation warning a bit in recent improvements on auth providers. And Discourse has changed a lot of site settings too. I’m thinking we probably need to provide more information about deprecation so that plugin authors know what’s going to be deprecated.
Discourse.deprecate only outputs a message. But I think we need to add two more named arguments.
deprecated_version: (optional) The version we started to deprecate an API.
drop_version: The version we plan to drop this API. This also serves as a good documentation.