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
20786	Importing exceptions: documentation should be more explicit and clearer	Daniele Procida	Dominic Rodger	"At https://docs.djangoproject.com/en/dev/ref/exceptions, for some of the listed exceptions information is provided on how to import it.

For example: ""The UnreadablePostError is raised when a user cancels an upload. It is available from django.http.""

For others though (e.g. https://docs.djangoproject.com/en/dev/ref/exceptions/#noreversematch) there isn't clear explicit information about where to get them from.

Also, when the information is provided, it's not always provided consistently.

My suggestion is that each section (Database Exceptions, Http Exceptions and so on) there should begin with a paragraph on its own: ''Core exceptions are provided in django.core.exceptions'', ''Database exceptions are provided in django.db'' and so on.

FInally, ''Django-specific Exceptions'' seems a bit of a misnomer, since others not in that section are also Django-specific.  Calling them ''Core exceptions'' would seem to make more sense."	Uncategorized	closed	Documentation	dev	Normal	fixed		internet@…	Accepted	1	0	0	0	1	0