#14546 closed (duplicate)
Queryset docs should drop some legacy Django 1.0 instructions
Reported by: | Paul McMillan | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | 1.2 |
Severity: | Keywords: | ||
Cc: | Triage Stage: | Accepted | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
http://docs.djangoproject.com/en/1.2/ref/models/querysets/#in
The queryset docs show some roundabout ways to do in
lookups, but then have this confusing note:
"Changed in Django 1.1: In Django 1.0, only the latter piece of code is valid."
A user not paying attention is likely to misinterpret this.
We don't need to be teaching users reading the Django 1.3 docs how to build code that's compatible with Django 1.0. The example and the note should be removed.
Change History (4)
comment:1 by , 14 years ago
comment:2 by , 14 years ago
Triage Stage: | Unreviewed → Accepted |
---|
Note:
See TracTickets
for help on using tickets.
On second thought, the example probably should stay (shows a useful way of doing things) but the note should go away and that section should possibly be re-ordered a bit to flow more easily.