Opened 2 years ago

Closed 4 days ago

Last modified 4 days 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 Changed 2 years ago by Adrian Turjak

Owner: changed from nobody to Adrian Turjak
Status: newassigned
Last edited 20 months ago by Tim Graham (previous) (diff)

comment:2 Changed 2 years ago by Carlton Gibson

Has patch: set
Patch needs improvement: set
Triage Stage: UnreviewedAccepted

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

comment:3 Changed 12 months ago by Tapasweni Pathak

Hello folks: Can I take the ticket?

comment:4 in reply to:  3 Changed 12 months ago by felixxm

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?

comment:5 in reply to:  3 Changed 12 months ago by Adrian Turjak

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 Changed 11 months ago by frnhr

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

comment:7 Changed 13 days ago by David Smith

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

comment:8 Changed 11 days ago by David Smith

Has patch: set

comment:9 Changed 4 days ago by Carlton Gibson

Triage Stage: AcceptedReady for checkin

comment:10 Changed 4 days ago by Carlton Gibson <carlton@…>

Resolution: fixed
Status: assignedclosed

In 2c2f4b37:

Fixed #29336 -- Doc'd circular template inheritance

comment:11 Changed 4 days ago by Carlton Gibson <carlton.gibson@…>

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