#10053 closed (fixed)
Incorrect pydoc in django.template.loaders.app_directories.load_template_source
| Reported by: | kylev | Owned by: | nobody |
|---|---|---|---|
| Component: | Documentation | Version: | 1.0 |
| Severity: | Keywords: | ||
| Cc: | Triage Stage: | Ready for checkin | |
| Has patch: | no | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | no | UI/UX: | no |
Description
The pydoc for this code is misleading:
""" Wrapper for loading templates from "template" directories in INSTALLED_APPS packages. """
In fact, the code builds the template path thusly:
template_dir = os.path.join(os.path.dirname(mod.__file__), 'templates')
Please fix the pydoc to say "templates/" as it will reduce frustration a little when building self-contained apps. It might also be useful to mention in tutorials that this functionality is in place by default, since it alleviates the need to fiddle with the project-wide TEMPLATE_DIRS setting.
Attachments (1)
Change History (5)
by , 15 years ago
| Attachment: | django-templates-doc.patch added |
|---|
comment:1 by , 15 years ago
| milestone: | → 1.1 |
|---|---|
| Triage Stage: | Unreviewed → Accepted |
comment:2 by , 15 years ago
| Component: | Template system → Documentation |
|---|---|
| Triage Stage: | Accepted → Ready for checkin |
Note:
See TracTickets
for help on using tickets.
The most exciting patch you'll ever see.