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
25386	Unclear documentation for default debug setting for DjangoTemplates engine	lightstrike	Deborah	"In 1.8, the TEMPLATE_DEBUG setting is deprecated in favor of setting 'debug' as part of the OPTIONS sub-setting in a backend in TEMPLATES. 

In a couple parts of the documentation, it is stated that the default 'debug' setting for DjangoTemplates engine is False:

* [https://docs.djangoproject.com/en/dev/ref/templates/api/#configuring-an-engine Template API]
* [https://docs.djangoproject.com/en/1.8/ref/settings/#template-debug Settings:TEMPLATE_DEBUG]

In reality, the default is [https://github.com/django/django/blob/aaacaeb0963c406c4fe6f68c6ae51f4a65878250/django/template/backends/django.py#L28 apparently set according to settings.DEBUG].

I suggest clarifying the documentation to state that the default debug setting is equal to settings.DEBUG (which is True by default). It would be additionally helpful to link to the possible options one can set in a template engine on the [https://docs.djangoproject.com/en/1.8/ref/settings/#std:setting-TEMPLATES-OPTIONS main settings page]."	Cleanup/optimization	closed	Documentation	1.8	Normal	fixed	template, template engine		Accepted	1	0	0	0	1	0