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
32521	Possible documentation error re. template directories	Mike Slinn	nobody	"[https://docs.djangoproject.com/en/3.1/howto/overriding-templates/#overriding-from-an-app-s-template-directory The docs] say ""Since you’re overriding templates located outside of one of your project’s apps, it’s more common to **use the first method** and put template overrides in a project’s templates folder.""

It is unclear what ""the first method"" might be. Earlier in the page there was no mention of an enumeration of options.

I believe I know what the page is trying to communicate, that there are two places to put templates:

1) Per app (template subdirectory within each app directory)

2) Per project (top-level /templates directory)

I believe that the first place shown above is ""the first method"". It would be less confusing if this was spelled out better. The rest of the page continues the confusion. Apparently per-app templates are preferred, but there is not a single example of this, nor a directory layout image, and instead all the detail goes to the per-project option. 

Even the section entitled [https://docs.djangoproject.com/en/3.1/howto/overriding-templates/#overriding-from-an-app-s-template-directory Overriding from an app’s template directory] does not discuss per-app templates, and again shows a per-project template directory.

A newbie like me is left scratching his head."	Cleanup/optimization	closed	Documentation	3.1	Normal	invalid			Unreviewed	0	0	0	0	0	0