Near mentions of TEMPLATE_DIRS absolute path, include tip dynamic absolute path
|Reported by:||Jeff Kowalczyk <jtk@…>||Owned by:||nobody|
|Severity:||Keywords:||path template absolute|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
Most documentation of settings.TEMPLATE_DIRS instructs the user to use absolute paths, in the form of a hardcoded string literal absolute path.
A new user would immediately wonder if they needed to plan their deployment absolute path right then and there.
To avoid this surprise, it would be helpful to note that the absolute path can be created dynamically, such as with:
TEMPLATE_DIRS = (os.path.join(os.path.abspath(os.path.dirname(__file__)), 'templates'),)