#32521: Possible documentation error re. template directories
-----------------------------------------+------------------------
Reporter: Mike Slinn | Owner: nobody
Type: Uncategorized | Status: new
Component: Documentation | Version: 3.1
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-----------------------------------------+------------------------
[https://docs.djangoproject.com/en/3.1/howto/overriding-templates
/#overriding-from-an-app-s-template-directory The docs] say "Since you’re
overriding templates located outside of one of your project’s apps, it’s
more common to **use the first method** and put template overrides in a
project’s templates folder."
It is unclear what "the first method" might be. Earlier in the page there
was no mention of an enumeration of options.
I believe I know what the page is trying to communicate, that there are
two places to put templates:
1) Per app (template subdirectory within each app directory)
2) Per project (top-level /templates directory)
I believe that the first place shown above is "the first method". It would
be less confusing if this was spelled out better. The rest of the page
continues the confusion. Apparently per-app templates are preferred, but
there is not a single example of this, nor a directory layout image, and
instead all the detail goes to the per-project option.
Even the section entitled [https://docs.djangoproject.com/en/3.1/howto
/overriding-templates/#overriding-from-an-app-s-template-directory
Overriding from an app’s template directory] does not discuss per-app
templates, and again shows a per-project template directory.
A newbie like me is left scratching his head.
--
Ticket URL: <https://code.djangoproject.com/ticket/32521>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/049.13875c0c3145e9c0b8573768fcda078c%40djangoproject.com.
