Opened 8 years ago

Closed 8 years ago

Last modified 5 years ago

#10091 closed (fixed)

QuerySet documentation of slicing syntax misleading/incomplete

Reported by: adrian_nye Owned by: Jacob
Component: Documentation Version: 1.0
Severity: Keywords: QuerySet
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

Doc says: "Use Python's array-slicing syntax to limit your QuerySet to a certain number of results."

Should say: "Use a subset of Python's array-slicing syntax to limit your QuerySet to a certain number of results."

Should also say: specifically mention that it doesn't accept negative indexes. [-1] does not work for example.

Would be nice: give an example of how to return the last (single) item in a queryset. A good example would be: return the item with the most
recent datetime.

Change History (4)

comment:1 Changed 8 years ago by Jacob

milestone: 1.1
Triage Stage: UnreviewedAccepted

comment:2 Changed 8 years ago by Jacob

Owner: changed from nobody to Jacob
Status: newassigned

comment:3 Changed 8 years ago by Jacob

Resolution: fixed
Status: assignedclosed

(In [10371]) Fixed a whole bunch of small docs typos, errors, and ommissions.

Fixes #8358, #8396, #8724, #9043, #9128, #9247, #9267, #9267, #9375, #9409, #9414, #9416, #9446, #9454, #9464, #9503, #9518, #9533, #9657, #9658, #9683, #9733, #9771, #9835, #9836, #9837, #9897, #9906, #9912, #9945, #9986, #9992, #10055, #10084, #10091, #10145, #10245, #10257, #10309, #10358, #10359, #10424, #10426, #10508, #10531, #10551, #10635, #10637, #10656, #10658, #10690, #10699, #19528.

Thanks to all the respective authors of those tickets.

comment:18 Changed 5 years ago by Jacob

milestone: 1.1

Milestone 1.1 deleted

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