This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Joseph Schachner
Recipients Joseph Schachner, docs@python
Date 2015-08-24.13:08:31
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1440421712.73.0.607673856693.issue24921@psf.upfronthosting.co.za>
In-reply-to
Content
We should not make people who need to read Python documentation do an extra transformation in their heads to correctly understand that in section 5.15 higher precedence is at the bottom of the table and lower precedence is at the top. Because the documentation has this table inverted from the way it is usually presented in other references, one of the top hits in a Google search shows an instructor felt the need to make a version in the usual "high to low precedence" order to show students, see:
http://www.mathcs.emory.edu/~valerie/courses/fall10/155/resources/op_precedence.html
That version is so much more comfortable for me to read, it seems almost strange, but it is true. Please consider changing section 5.15 so it would not need the top paragraph explaining that the table order is not what the reader probably expects, instead just present the table as at the link above - in the order the reader does expect - higher precedence on top, lower on the bottom. That only needs two short sentences of explanation that don't make the reader think "wait ... what?"
History
Date User Action Args
2015-08-24 13:08:32Joseph Schachnersetrecipients: + Joseph Schachner, docs@python
2015-08-24 13:08:32Joseph Schachnersetmessageid: <1440421712.73.0.607673856693.issue24921@psf.upfronthosting.co.za>
2015-08-24 13:08:32Joseph Schachnerlinkissue24921 messages
2015-08-24 13:08:31Joseph Schachnercreate