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
25010	TEMPLATES settings documentation is confusing about APP_DIRS	Daniel Quinn	nobody	"The documentation for the `TEMPLATES` setting https://docs.djangoproject.com/en/1.8/ref/settings/#templates says that `APP_DIR` defines whether or not Django should source templates from the `templates` directory inside each app directory.  In the simple example given, `APP_DIR` is set to `True`, which is a little weird because this is the default setup you get when you run `startproject`.

However, further down in the same section, the default for `APP_DIR` is defined as `False`, so when I first read this, I thought that I needed to use the example snippet to turn on what was already the default behaviour.  It's all very confusing.

To fix this, I think the best option would be to:

* Document that the default for `APP_DIR` is True (unless this isn't the case and I'm missing something)
* Modify the example to do something other than the default behaviour.  This part isn't necessary, but coupled with the above problem, none of this makes sense on first reading."	Cleanup/optimization	closed	Documentation	1.8	Normal	fixed			Accepted	1	0	0	0	0	0