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
29146	re_path() examples are missing ^ and $ in regexes	Seohong Park	nobody	"An example about the usage of {{{re_path()}}} in 'URL dispatcher' document https://docs.djangoproject.com/en/2.0/topics/http/urls/ is misleading.

Since {{{re_path()}}} does not insert {{{'$'}}} at the end of URL parameter (on the contrast, {{{path()}}} inserts {{{'^'}}} and {{{'$'}}} at the beginning and the end of URL parameter),

{{{re_path('articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/', views.month_archive)}}} would not be mapped to any URL, because {{{re_path('articles/(?P<year>[0-9]{4})/', views.year_archive)}}} shades it.

(i.e. {{{'http://127.0.0.1:8000/articles/2018/12/'}}} invokes {{{views.year_archive}}}, not {{{views.month_archive}}})

This is misleading, because readers might think {{{re_path}}} also automatically inserts {{{'^'}}} and {{{'$'}}} to the parameter like {{{path}}} does.

I think it would be better to insert {{{'$'}}} at the end of each parameter of {{{re_path()}}} in the document.

Additionally, mentioning about the fact that {{{path()}}} automatically inserts {{{'^'}}} and {{{'$'}}} to the parameter also would be helpful."	Bug	closed	Documentation	2.0	Normal	fixed			Ready for checkin	1	0	0	0	1	0