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
33544	Hint to default behavior (Deployment checklist > TEMPLATES)	Samuel Hartmann	Samuel Hartmann	"In the [https://docs.djangoproject.com/en/4.0/howto/deployment/checklist/#templates TEMPLATES] part of Django's deployment checklist, they say:
> Enabling the cached template loader often improves performance drastically

In my understanding this sounds like ''the cached template loader isn't enabled by default'' - which I in turn consider misleading.
But in the link to the [https://docs.djangoproject.com/en/4.0/ref/templates/api/#django.template.loaders.cached.Loader template loaders docs] they explain:
> This loader is automatically enabled if OPTIONS!['loaders'] isn’t specified and OPTIONS!['debug'] is False (the latter option defaults to the value of DEBUG).

which in my understanding means:
""The cached template loader is enabled automatically, if one uses the default Django project settings but(!) with DEBUG being False (which is usually the case on deployment).""

**Therefore I suggest to add a hint to [https://docs.djangoproject.com/en/4.0/howto/deployment/checklist/#templates TEMPLATES] (in the deployment checklist), which points out that the cached template loader is enabled as soon as DEBUG is False.**
In practice it could look like this:
> Enabling the cached template loader often improves performance drastically, as it avoids compiling each template every time it needs to be rendered.
> When DEBUG = False, the cached template loader is enabled.
>
> See the template loaders docs for more information.

This would match the format of the [https://docs.djangoproject.com/en/dev/howto/deployment/checklist/#allowed-hosts ALLOWED_HOSTS] description
> When DEBUG = False, Django doesn’t work at all without a suitable value for ALLOWED_HOSTS.
...as well as [https://docs.djangoproject.com/en/dev/howto/deployment/checklist/#performance-optimizations Performance optimizations]
> Setting DEBUG = False disables several features that are only useful in development.

If this ticket gets accepted, I would gladly make the adjustments as my first contribution."	Cleanup/optimization	closed	Documentation	4.0	Normal	fixed	deployment checklist, TEMPLATES, DEBUG, documentation, docs		Ready for checkin	0	0	0	0	1	0