Re: [Django] #34122: Add reference docs for models.ForeignObject

9 views
Skip to first unread message

Django

unread,
Apr 20, 2026, 7:10:32 AM (11 days ago) Apr 20
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: nobody
Type: | Status: new
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Accepted
multiple column join, |
foreignobject |
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Sarah Boyce):

* stage: Unreviewed => Accepted

--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:7>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Apr 20, 2026, 10:02:43 AM (10 days ago) Apr 20
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: nobody
Type: | Status: new
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Accepted
multiple column join, |
foreignobject |
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Sarah Boyce <42296566+sarahboyce@…>):

In [changeset:"2c87f519f48038398c8d8a840fa5bf5497c353bb" 2c87f51]:
{{{#!CommitTicketReference repository=""
revision="2c87f519f48038398c8d8a840fa5bf5497c353bb"
Refs #373, #34122 -- Removed warning that ForeignObject is an internal
tool.

ForeignObject should not be treated as an internal tool. In the past
we made changes in its API with a proper deprecation, e.g.
8b1ff0da4b162e87edebd94e61f2cd153e9e159d.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:8>

Django

unread,
Apr 20, 2026, 10:06:03 AM (10 days ago) Apr 20
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: nobody
Type: | Status: new
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Accepted
multiple column join, |
foreignobject |
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Sarah Boyce <42296566+sarahboyce@…>):

In [changeset:"8ee73415270a1a54daaec9bb529ad82c6f7a6d4c" 8ee7341]:
{{{#!CommitTicketReference repository=""
revision="8ee73415270a1a54daaec9bb529ad82c6f7a6d4c"
[6.0.x] Refs #373, #34122 -- Removed warning that ForeignObject is an
internal tool.

ForeignObject should not be treated as an internal tool. In the past
we made changes in its API with a proper deprecation, e.g.
8b1ff0da4b162e87edebd94e61f2cd153e9e159d.

Backport of 2c87f519f48038398c8d8a840fa5bf5497c353bb from main.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:9>

Django

unread,
Apr 25, 2026, 2:47:18 AM (6 days ago) Apr 25
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: somi
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Accepted
multiple column join, |
foreignobject |
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by somi):

* owner: nobody => somi
* status: new => assigned

Comment:

Picking this up. Plan to mirror the ForeignKey reference structure.
Thanks for reopening!
--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:10>

Django

unread,
Apr 25, 2026, 3:57:23 AM (6 days ago) Apr 25
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: somi
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Accepted
multiple column join, |
foreignobject |
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by somi):

* has_patch: 0 => 1

--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:11>

Django

unread,
Apr 25, 2026, 7:14:33 AM (6 days ago) Apr 25
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: somi
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Accepted
multiple column join, |
foreignobject |
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Mariusz Felisiak):

* has_patch: 1 => 0

--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:12>

Django

unread,
Apr 25, 2026, 8:23:36 AM (6 days ago) Apr 25
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: somi
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Accepted
multiple column join, |
foreignobject |
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by somi):

* has_patch: 0 => 1

--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:13>

Django

unread,
Apr 25, 2026, 8:56:19 AM (6 days ago) Apr 25
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: somi
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Accepted
multiple column join, |
foreignobject |
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by somi):

[https://github.com/django/django/pull/21173 PR]
--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:14>

Django

unread,
Apr 29, 2026, 9:31:44 PM (yesterday) Apr 29
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: somi
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Ready for
multiple column join, | checkin
foreignobject |
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by H. White):

* stage: Accepted => Ready for checkin

Comment:

Reviewed, approved.
--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:15>

Django

unread,
12:31 AM (21 hours ago) 12:31 AM
to django-...@googlegroups.com
#34122: Add reference docs for models.ForeignObject
-------------------------------------+-------------------------------------
Reporter: Ömer Faruk Abacı | Owner: somi
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 4.1
Severity: Normal | Resolution:
Keywords: custom join, | Triage Stage: Accepted
multiple column join, |
foreignobject |
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Mariusz Felisiak):

* needs_better_patch: 0 => 1
* stage: Ready for checkin => Accepted

--
Ticket URL: <https://code.djangoproject.com/ticket/34122#comment:16>
Reply all
Reply to author
Forward
0 new messages