#15257: Suggestion: examples of double-underscore usage/meaning
-----------------------------+----------------------------------------------
Reporter: MixedContent | Owner: nobody
Status: new | Milestone:
Component: Documentation | Version: 1.2
Keywords: syntax examples | Triage Stage: Unreviewed
Has patch: 0 |
-----------------------------+----------------------------------------------
On this page:
http://docs.djangoproject.com/en/1.2/intro/tutorial01
this text appears:
====
# The API automatically follows relationships as far as you need.
# Use double underscores to separate relationships.
# This works as many levels deep as you want; there's no limit.
# Find all Choices for any poll whose pub_date is in 2007.
====
The use of double-underscore as a syntactic element is not familiar to me.
I accept without objection that it *is* used in this context, but it is
unfamiliar. Since the audience for this tutorial *probably* includes at
least *some* people as ignorant as I am, maybe a separate page for some
examples of how the double-underscore syntax relates to particular object
references would be helpful. (E.g., "See examples _here_", linking to a
page with examples, "this__that__the-other" ==> "this.that.the-other"
etc.)
Since I explicitly lack experience here, my recommendation could be
completely wrong; I leave that to you.
--
Ticket URL: <http://code.djangoproject.com/ticket/15257>
Django <http://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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.
