#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: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+------------------------------------------
Changes (by Jacob Walls):
* has_patch: 1 => 0
Comment:
Hi, thanks for your interest here.
> 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.
I closed the PR just now, because while there are elements in there that
have a resemblance to what we want, I suspect that it was not sourced by
"surfing Trac, Discord, and the forum to collect frequently-asked-
questions".
For instance, here is a helpful forum post that could have been adapted
into an example:
https://forum.djangoproject.com/t/advanced-postgresql-functions-like-json-
to-recordset-json-jsonb-to-recordset-jsonb/35542/4
I understand my guidance may have been a little vague--and that in the
face of vagueness, an LLM can provide a starting point--but I'm hoping
we'll develop something written in the voice of a Django user, not in the
voice of an LLM, since users already have access to that kind of
documentation themselves.
Also, the PR includes extraneous things like a list of lookups and
transforms, which we already have. It also redundantly instructs how to
chain lookups together.
If others who try to pick up this ticket find the guidance too vague to be
actionable, we can set it to `needsinfo` or `Someday` pending a proof of
concept, but I'm hoping we won't have to do that just yet.
--
Ticket URL: <https://code.djangoproject.com/ticket/36657#comment:5>
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/01070199e4610c44-5ee36abc-13ef-45a8-b1c0-5a16055b2bb8-000000%40eu-central-1.amazonses.com.
