Message371690
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. |
|
Date |
User |
Action |
Args |
2020-06-16 19:14:55 | Sydney Pemberton | set | recipients:
+ Sydney Pemberton, docs@python |
2020-06-16 19:14:55 | Sydney Pemberton | set | messageid: <1592334895.01.0.222155011801.issue40994@roundup.psfhosted.org> |
2020-06-16 19:14:54 | Sydney Pemberton | link | issue40994 messages |
2020-06-16 19:14:54 | Sydney Pemberton | create | |
|