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 Sydney Pemberton
Recipients Sydney Pemberton, docs@python
Date 2020-06-16.19:14:54
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1592334895.01.0.222155011801.issue40994@roundup.psfhosted.org>
In-reply-to
Content
I was writing a Jupyter notebook at the time, which I think perfectly illustrated the blind alley this documentation bug led me down before beating me up and stealing my lunch money.

I have come to this point in the documentation at least half a dozen times while learning Python and always left confused and with the sense that Python is more complicated than I had thought. 

Notebook attached. 

This documentation style violates two principles:
 - The implied structure of headings and content below it.
 - Many natural languages do not contain context-sensitive grammar and so using the "respectively" idiom can be very confusing for people who speak English as a second language.
History
Date User Action Args
2020-06-16 19:14:55Sydney Pembertonsetrecipients: + Sydney Pemberton, docs@python
2020-06-16 19:14:55Sydney Pembertonsetmessageid: <1592334895.01.0.222155011801.issue40994@roundup.psfhosted.org>
2020-06-16 19:14:54Sydney Pembertonlinkissue40994 messages
2020-06-16 19:14:54Sydney Pembertoncreate