Template Discovery Override is Unclear & Error-Prone

[wesleyboar]

Note

Generated by AI. Edited by @wesleyboar.

Summary

The TEMPLATES['DIRS'] setting in taccsite_cms/settings.py uses globbing to include taccsite_custom folders ahead of app templates. While intended to let site-specific templates override packaged templates, the glob and ordering can be opaque and result in accidental shadowing.

Files / Locations

• taccsite_cms/settings.py: TEMPLATES['DIRS'] configuration

Problems / Impact

• Accidental shadowing: similarly-named templates in taccsite_custom subdirs may override package templates unexpectedly.
• Order/priority can vary depending on filesystem ordering of glob results.
• Difficult to audit which custom templates are active.

Client Apps

These apps rely on TACC/Core-CMS:

• https://github.com/TACC/tup-ui/tree/v1.1.17/apps/tup-cms/src
• https://github.com/TACC/APCD-CMS/tree/v1.3.1/apcd_cms/src
• https://github.com/TACC/Texascale-CMS/tree/v1.3.0/cms/src