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
19728	Update API stability doc	Aymeric Augustin	nobody	"https://docs.djangoproject.com/en/dev/misc/api-stability/ says that public APIs include:
- everything that's documented
- everything that isn't underscore-prefixed

As far as I can tell, the underscore convention isn't widely used in Django, and in practice we consider that only documented API are public.

Besides:
- the list of stable APIs in the document is most likely out of date.
- special casing django.utils doesn't seem very useful nor user-friendly.

I suggest to update this doc to reflect the current practice. We could simply say: ""everything that's documented is stable ie. subject to a deprecation policy for major changes.""

I'm opening this ticket after an IRC discussion that also led to [https://groups.google.com/d/topic/django-users/vGj8RWY1OE8/discussion thread on django-users]."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed			Accepted	1	0	0	0	0	0