admindoc :template: role should not append .html
Many other template suffixes are used besides .html
, for example .txt
, .js
, .xml
, etc. If developers want to document those templates in their docstrings they are out of luck because Django currently appends .html
to the filename that is passed into the view. The attached patch will fix the problem, but it is backwards incompatible.
Change History
(8)
milestone: |
→ 1.1
|
Resolution: |
→ fixed
|
Status: |
new → closed
|
Triage Stage: |
Unreviewed → Accepted
|
Resolution: |
fixed
|
Status: |
closed → reopened
|
Component: |
Uncategorized → django.contrib.admin
|
Triage Stage: |
Accepted → Ready for checkin
|
Resolution: |
→ fixed
|
Status: |
reopened → closed
|
We can deal with this after 1.0. We're not guaranteeing that documentation will never change (even documentation generated from comments).