Opened 15 years ago
Closed 15 years ago
#11724 closed (wontfix)
Python slice syntax is not the same as SQL offset limit syntax
Reported by: | anonymous | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | 1.1 |
Severity: | Keywords: | ||
Cc: | Triage Stage: | Unreviewed | |
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.0/topics/db/queries/#id4
http://docs.djangoproject.com/en/dev/topics/db/queries/#id4
The docs infer that when slicing you specify the start record and an offset, Python slice syntax requires the first record to show and the first record not to show, something totally different.
SQL: start record, show n records
python slice: show records >= n, don't show records >= n
The way it's worded is very misleading for those unfamiliar with python slice syntax.
The docs are quite clear, the second example in particular addresses your concern. If you have a particular suggestion as to how this could be reworded feel free to reopen, but I think it's fine.