#36657: Make advanced ORM functionality more discoverable
-------------------------------+------------------------------------------
Reporter: Lily | Owner: Segni Mekonnen
Type: New feature | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+------------------------------------------
Changes (by Segni Mekonnen):
* has_patch: 0 => 1
* owner: (none) => Segni Mekonnen
* status: new => assigned
Comment:
Working on this ticket. PR submitted:
https://github.com/django/django/pull/19961
Created comprehensive advanced ORM documentation including:
**How-to Guide (advanced-orm-techniques.txt):**
- 12 scaffolded examples from basic to advanced complexity
- Built around consistent sample models (Article, Author, Comment)
- Covers custom functions, lookups, transforms, subqueries, and window
functions
- Each example includes real-world use cases and performance
considerations
**Built-in Lookups Reference (lookups-builtin.txt):**
- Complete list of all Django built-in lookups
- Examples and SQL equivalents for each lookup
- Cross-referenced with transforms and functions
**Built-in Transforms Reference (transforms-builtin.txt):**
- Complete list of all Django built-in transforms
- Examples showing transform chaining
- Cross-referenced with lookups and functions
**Improved Discoverability:**
- Added cross-links between how-to guide and reference docs
- Updated index pages to include new references
- All documentation follows Django's style guide
The implementation addresses all requirements from the ticket description
and follows Jacob's guidance for a "carefully scaffolded journey" rather
than a dumping ground of examples.
Ready for review.
--
Ticket URL: <https://code.djangoproject.com/ticket/36657#comment:4>
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/01070199e458aff9-9e1b4a7b-3a7a-4b8b-956d-3f640b673b95-000000%40eu-central-1.amazonses.com.
