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
22220	reverse() documentation	Daniele Procida	Ben Davis	"https://docs.djangoproject.com/en/dev/ref/urlresolvers/#reverse:

{{{
reverse(viewname[, urlconf=None, args=None, kwargs=None, current_app=None])
viewname is either the function name (either a function reference, or the string version of the name, if you used that form in urlpatterns) or the URL pattern name.
}}}

I think this could be clearer. 

* there should be a link to an example of each of the different ways in the documentation (only ""URL pattern name"" is elucidated this way)
* the phrase ""function reference"" is confusing; https://docs.djangoproject.com/en/dev/topics/http/urls/#passing-callable-objects-instead-of-strings speaks of ""passing objects"" for example and the same language should be used in both cases.

And what if one creates a URL pattern name that's the also the string version of the view function name - which would win?


"	Cleanup/optimization	closed	Documentation	1.6	Normal	fixed			Accepted	1	0	0	0	1	0