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