[issue31152] Tutorial wording implies an understanding of a concept prior to it being introduced

2017-08-09 Thread Raymond Hettinger
Raymond Hettinger added the comment: Emily, thanks for the second review. Lorem, thanks for the suggestion, but we're going to decline. -- resolution: -> rejected stage: -> resolved status: open -> closed ___ Python tracker

[issue31152] Tutorial wording implies an understanding of a concept prior to it being introduced

2017-08-09 Thread Emily Morehouse
Emily Morehouse added the comment: I concur with Raymond, particularly because paragraph 1 of section 8.5 links to the Classes tutorial which covers inheritance. I think the documentation is sufficient as is. -- nosy: +emilyemorehouse ___ Python tra

[issue31152] Tutorial wording implies an understanding of a concept prior to it being introduced

2017-08-08 Thread Raymond Hettinger
Raymond Hettinger added the comment: It is okay for the tutorial to occasionally have forward references. Python is a fully object oriented language so references to classes and instances will appear in many places. AFAICT, this particular passage has never caused any reported difficulty for

[issue31152] Tutorial wording implies an understanding of a concept prior to it being introduced

2017-08-08 Thread Lorem Ipsum
New submission from Lorem Ipsum: Python 3.5.4 Tutorial Section 8.5. User-defined Exceptions Paragraph 2 (https://docs.python.org/3.5/tutorial/errors.html#user-defined-exceptions) states [emphasis mine]: "When creating a module that can raise several distinct errors, a common practice is to cr