#25386 closed Cleanup/optimization (fixed)
Unclear documentation for default debug setting for DjangoTemplates engine
Reported by: | lightstrike | Owned by: | Deborah |
---|---|---|---|
Component: | Documentation | Version: | 1.8 |
Severity: | Normal | Keywords: | template, template engine |
Cc: | Triage Stage: | Accepted | |
Has patch: | yes | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | yes | UI/UX: | no |
Description
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:
In reality, the default is 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 main settings page.
Change History (8)
comment:1 by , 9 years ago
comment:2 by , 9 years ago
Owner: | changed from | to
---|---|
Status: | new → assigned |
comment:5 by , 9 years ago
Triage Stage: | Unreviewed → Accepted |
---|
Accepting on the basis that the "Configuration an Engine" section of the docs could use an upfront warning that if you're simply using DjangoTemplates
, this isn't the documentation you're looking for (as described on the pull request).
The default value for
DjangoTemplates
is documented elsewhere from the places you linked. I think those other places are correct, but please clarify if you believe otherwise.I'll propose this patch to address your last point:
docs/ref/settings.txt