Opened 10 years ago

Closed 10 years ago

Last modified 10 years ago

#23094 closed Cleanup/optimization (fixed)

QuerySet API docs: Sample code doesn't match

Reported by: thegeekofalltrades@… Owned by: Tim Graham
Component: Documentation Version: 1.7-beta-2
Severity: Normal Keywords: documentation error mismatch match sample
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description (last modified by Tim Graham)

On the QuerySet API documentation page, under the section for select_related (https://docs.djangoproject.com/en/dev/ref/models/querysets/#django.db.models.query.QuerySet.select_related), in the section about following foreign keys, the documentation reads:

"...then a call to Book.objects.select_related('person', 'person__city').get(id=4) will cache the related Person and the related City:"

and the sample code that follows it reads:

b = Book.objects.select_related('person__city').get(id=4)

The arguments passed to select_related do not match.

The error is present in both the Dev docs and the 1.7 docs.

Change History (4)

comment:1 by Tim Graham, 10 years ago

Description: modified (diff)

comment:2 by Tim Graham, 10 years ago

Owner: changed from nobody to Tim Graham
Status: newassigned
Triage Stage: UnreviewedAccepted
Type: UncategorizedCleanup/optimization

comment:3 by Tim Graham <timograham@…>, 10 years ago

Resolution: fixed
Status: assignedclosed

In 5f919b9c81a26832f98033335a601ec1ca718db7:

Fixed #23094 -- Removed redundant argument in select_related() example.

Thanks thegeekofalltrades at gmail.com for the report.

comment:4 by Tim Graham <timograham@…>, 10 years ago

In 5822ca6c108e4cde134e55632dbaf79aeead1777:

[1.7.x] Fixed #23094 -- Removed redundant argument in select_related() example.

Thanks thegeekofalltrades at gmail.com for the report.

Backport of 5f919b9c81 from master

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