# Deprecation warning improvement idea

**URL:** https://meta.discourse.org/t/deprecation-warning-improvement-idea/103241
**Category:** Development
**Created:** [1 december 2018 om 12:58 UTC](https://meta.discourse.org/t/deprecation-warning-improvement-idea/103241 "2018-12-01T12:58:53Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![fantasticfears](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/fantasticfears/32/119608_2.png) [@fantasticfears](https://meta.discourse.org/u/fantasticfears)
#### Post date: [1 december 2018 om 12:58 UTC](https://meta.discourse.org/t/deprecation-warning-improvement-idea/103241/1 "2018-12-01T12:58:54Z")

</div>

@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.

So far, `Discourse.deprecate` only outputs a message. But I think we need to add two more named arguments.

> <https://github.com/discourse/discourse/blob/555f467727e44ac1fc6659846116e7bcd65f6f07/lib/discourse.rb#L605-L620>

1. `deprecated_version`: (optional) The version we started to deprecate an API.
2. `drop_version`: The version we plan to drop this API. This also serves as a good documentation.