#36657: Make advanced ORM functionality more discoverable
----------------------+-----------------------------------------
Reporter: Lily | Type: Uncategorized
Status: new | Component: Documentation
Version: dev | Severity: Normal
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
----------------------+-----------------------------------------
At Django on the Med we were discussing how many Django users reach for
raw SQL because they don't realise that Django provides tools to allow
building their query with the ORM.
I think there are several things we can do to improve the documentation
here:
* Add a how-to page explaining how to create custom database functions
with `Func`, custom lookups with `Lookup` and custom transforms with
`Transform`.
* Refactor the lookups reference page
(https://docs.djangoproject.com/en/5.2/ref/models/lookups/) to include a
list of the builtin lookups or create a new page.
* Add a page listing the builtin transforms.
* Add crosslinks between the how-to page and the reference docs for lists
of builtin functions, lookups and transforms.
--
Ticket URL: <https://code.djangoproject.com/ticket/36657>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion visit
https://groups.google.com/d/msgid/django-updates/01070199d2e0b09d-b5a1fd99-6348-4f80-995a-ec6c27a5241d-000000%40eu-central-1.amazonses.com.
