id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
21024	In the contributing guide document how to deprecate a feature	Tim Graham	nobody	"Somewhere in `internals/contributing` we document guidelines for deprecating a feature. I couldn't find anything on this after a quick search.

This includes how to silence deprecation warnings:

When a feature is deprecated, it raises a `PendingDeprecationWarning`, either at import time or at run time. After the following release it raises `DeprecationWarning`. Assuming we have a good test coverage, these warnings will be shown by the test suite, with `-Wall` for `PendingDeprecationWarning`, or by default for `DeprecationWarning`. This is annoying. The output of the test suite should remain clean.

Aymeric's full post including how to silence warnings:
https://groups.google.com/forum/#!topic/django-developers/nXlNqpy6sC8

"	Cleanup/optimization	new	Documentation	dev	Normal				Accepted	0	0	0	0	0	0