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
18939	usage of url template tag under-documented	John D'Ambrosio	nobody	"Hello,
While learning about the {% url %} template tag, I found the documentation to be inadequate in one section and incorrect in another.  Forums answered my question, but I just wanted to bring it to your attention.  I have the snippets below.
Thanks, John

https://docs.djangoproject.com/en/dev/ref/templates/builtins/

''Reads''
If you're using named URL patterns, you can refer to the name of the pattern in the url tag instead of using the path to the view.

''Recommend''
If you're using named URL patterns, you can refer to the name of the pattern in the url tag '''without quotation marks''' instead of using the path to the view.

https://docs.djangoproject.com/en/dev/topics/http/urls

''Reads''
Here's the above example, rewritten to use named URL patterns:

urlpatterns = patterns(' ',
    url(..., name=""full-archive""),
    url(..., ""arch-summary""),
)

With these names in place (full-archive and arch-summary), you can target each pattern individually by using its name:

{% url 'arch-summary' 1945 %}
{% url 'full-archive' 2007 %}

''Recommend''
{% url '''arch-summary''' 1945 %}
{% url '''full-archive''' 2007 %}"	Uncategorized	closed	Documentation	dev	Normal	invalid			Unreviewed	0	0	0	0	0	0