Opened 8 years ago

Closed 5 years ago

Last modified 5 years ago

#29336 closed Cleanup/optimization (fixed)

No docs for circular template inheritance

Reported by: Adrian Turjak Owned by: David Smith
Component: Documentation Version: 2.0
Severity: Normal Keywords:
Cc: frnhr Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

Proper support for circular (recursive) inheritance has been possible since https://code.djangoproject.com/ticket/22232 was fixed. But we don't have any docs for this, or at least none that appear to be easy to find.

This is a very useful feature. It allows a lot of power and flexibility without the need to create many template overrides.

Before Django properly supported this, most of us used: ​https://github.com/stephenmcd/django-overextends

The docs from overextends with the basic example as there on that project are what Django needs. A clear explanation and example of what circular inheritance is, how it works, and how to use it.

Change History (11)

comment:1 by Adrian Turjak, 8 years ago

Owner: changed from nobody to Adrian Turjak
Status: new → assigned

​PR

Last edited 7 years ago by Tim Graham (previous) (diff)

comment:2 by Carlton Gibson, 8 years ago

Has patch: set
Patch needs improvement: set
Triage Stage: Unreviewed → Accepted

This would make a good addition to the ​Overriding Templates How-To.

comment:3 by Tapasweni Pathak, 6 years ago

Hello folks: Can I take the ticket?

in reply to:  3 comment:4 by Mariusz Felisiak, 6 years ago

I don't think that there is a need to reassign this ticket, discussion is in progress.

Replying to Tapasweni Pathak:

Hello folks: Can I take the ticket?

in reply to:  3 comment:5 by Adrian Turjak, 6 years ago

Replying to Tapasweni Pathak:

Hello folks: Can I take the ticket?

The current pull request is here:
​https://github.com/django/django/pull/9884

If you have opinions on this feature, or how it is documented, that is the place to voice it :)

comment:6 by frnhr, 6 years ago

Cc: frnhr added
Summary: No docs for circular inheritance → No docs for circular template inheritance

comment:7 by David Smith, 5 years ago

Has patch: unset
Owner: changed from Adrian Turjak to David Smith
Patch needs improvement: unset

​PR

comment:8 by David Smith, 5 years ago

Has patch: set

comment:9 by Carlton Gibson, 5 years ago

Triage Stage: Accepted → Ready for checkin

comment:10 by Carlton Gibson <carlton@…>, 5 years ago

Resolution: → fixed
Status: assigned → closed

In 2c2f4b37:

Fixed #29336 -- Doc'd circular template inheritance

comment:11 by Carlton Gibson <carlton.gibson@…>, 5 years ago

In b81cdaf2:

[3.1.x] Fixed #29336 -- Doc'd circular template inheritance

Backport of 2c2f4b37997daf84834547c8abd146cd6e9eac13 from master

Note: See TracTickets for help on using tickets.
Back to Top