id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
15257	Suggestion: examples of double-underscore usage/meaning	John Chandler	nobody	"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."		new	Documentation	1.2			syntax examples		Unreviewed	0		0	0	0	0