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
25711	The project template's URLconf doesn't follow the docs' convention for include()	Daniele Procida	Daniele Procida	"* in the tutorial https://docs.djangoproject.com/en/dev/intro/tutorial01/#write-your-first-view we advise to use `include('polls.urls'))`
* in the default project template https://github.com/django/django/blob/master/django/conf/project_template/project_name/urls.py#L12-L15 we advise to import the module and use `url(r'^blog/', include(blog_urls))`
* in https://docs.djangoproject.com/en/dev/topics/http/urls/#including-other-urlconfs we have examples of both - even in the same file

I think that we need to be more consistent and clearer about this.

For the tutorial and the default `urls.py` I like the use of a dotted string rather than an import; it's one less thing to do.

Other than that, should we generally prefer one style over another? I can imagine that a dotted string might sometimes help avoid a circular import or have related advantages, but otherwise they seem to behave in just the same way."	Bug	closed	Documentation	1.8	Normal	fixed			Accepted	0	0	0	0	0	0