Opened 11 years ago
Closed 11 years ago
#22124 closed Cleanup/optimization (fixed)
Expand the Documentation of Custom Lookups for V1.7
Reported by: | Maarten | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | dev |
Severity: | Normal | 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 (last modified by )
Custom Lookups look great, however, I find the documentation terse. Example: no explanation what
lhs, lhs_params = self.process_lhs(qn, connection)
is exactly.
The explanation:
lhs
The lhs (left-hand side) of a lookup tells us what we are comparing the rhs to. It is an object which implements the query expression API. This is likely to be a field, an aggregate or a subclass of Transform.
does not explain what lhs_params
might be. Also a search on process_lhs
on complete Django website only points to this page (no other pages).
Change History (2)
comment:1 by , 11 years ago
Description: | modified (diff) |
---|---|
Triage Stage: | Unreviewed → Accepted |
Type: | Uncategorized → Cleanup/optimization |
Version: | 1.6 → master |
comment:2 by , 11 years ago
Resolution: | → fixed |
---|---|
Status: | new → closed |
Note:
See TracTickets
for help on using tickets.
I'll mark this ticket as
accepted
on the basis that there's probably some improvements to be made on this fairly new part of our documentation.Are there other points beside the one you mentionned in the ticket that you think could be improved?