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,Derek Willis,"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.",,closed,Documentation,1.2,,fixed,syntax examples,,Accepted,1,0,0,0,0,0