Suggestion: examples of double-underscore usage/meaning
|Reported by:||John Chandler||Owned by:||Derek Willis|
|Has patch:||yes||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
Description (last modified by )
On this page:
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.