➜
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.
Created on 2020-08-26 18:15 by kagarwal, last changed 2022-04-11 14:59 by admin. This issue is now closed.
| Messages (8) | |||
|---|---|---|---|
| msg375945 - (view) | Author: Krishan (kagarwal) | Date: 2020-08-26 18:15 | |
Grammatical error (parallelism) in Python 3.8.5 documentation, "The Python Tutorial". First page first paragraph. The "it" refers to the Python programming language. It HAS...data structures and it IS...a simple but effective approach... Currently reads: Python is an easy to learn, powerful programming language. It has efficient high-level data structures and a simple but effective approach to object-oriented programming. Should read: Python is an easy to learn, powerful programming language. It has efficient high-level data structures and is a simple but effective approach to object-oriented programming. |
|||
| msg375946 - (view) | Author: Eric V. Smith (eric.smith) *  |
Date: 2020-08-26 18:23 | |
I read it as "It HAS ... data structures and it HAS ... a simple but effective approach ...". So if I were changing it I might add the second "has". Or maybe adding "uses" would be better. But I'm not sure it's a great sentence either way. |
|||
| msg375949 - (view) | Author: Steven D'Aprano (steven.daprano) * |
Date: 2020-08-26 18:31 | |
I don't think that Python, a computer language, IS an approach to OOP. A programming language HAS an approach to OOP. We would say "Python's approach to OOP is ..." so the approach is something that belongs to Python, it isn't Python itself. (My dog's approach to cats is to bark loudly and chase them. It would be wrong to say that my dog is to bark loudly and chase cats.) So the sentence is grammatically correct, inserting an "is" would make it incorrect. But perhaps it could be re-written to be more clear? It seems a little clumsy to me. |
|||
| msg376091 - (view) | Author: Terry J. Reedy (terry.reedy) * |
Date: 2020-08-30 00:09 | |
I agree that a second verb might be better but 'is' is wrong. How about Python has ... and uses a simple but effective approach .. |
|||
| msg399209 - (view) | Author: Andrei Kulakov (andrei.avk) *  |
Date: 2021-08-08 04:11 | |
+1 for '... and uses a simple but effective approach ..' |
|||
| msg399210 - (view) | Author: Terry J. Reedy (terry.reedy) * |
Date: 2021-08-08 05:41 | |
This is not worth much more energy. Let's either add 'uses' or 'it uses' or close as 'works for me'. Lukasz, do you have a vote either way? I don't care which of us does a PR if we go that way. |
|||
| msg399240 - (view) | Author: Raymond Hettinger (rhettinger) * |
Date: 2021-08-08 20:22 | |
To my ears, the sentence reads nicely. I vote for leaving it as is. |
|||
| msg399242 - (view) | Author: Carol Willing (willingc) * |
Date: 2021-08-08 21:41 | |
I've run the two sentences through Grammarly's checker. No errors were flagged for the sentence in question. Let's leave "as is". Thanks to all who discussed this issue. |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022-04-11 14:59:35 | admin | set | github: 85811 |
| 2021-08-08 21:41:06 | willingc | set | status: open -> closed nosy: + willingc messages: + msg399242 resolution: not a bug stage: resolved |
| 2021-08-08 20:22:06 | rhettinger | set | nosy:
+ rhettinger messages: + msg399240 |
| 2021-08-08 05:41:23 | terry.reedy | set | nosy:
+ lukasz.langa messages: + msg399210 versions: + Python 3.11, - Python 3.8 |
| 2021-08-08 04:11:12 | andrei.avk | set | nosy:
+ andrei.avk messages: + msg399209 |
| 2020-08-30 00:09:01 | terry.reedy | set | nosy:
+ terry.reedy messages: + msg376091 |
| 2020-08-26 18:31:42 | steven.daprano | set | nosy:
+ steven.daprano messages: + msg375949 |
| 2020-08-26 18:23:42 | eric.smith | set | nosy:
+ eric.smith messages: + msg375946 |
| 2020-08-26 18:15:24 | kagarwal | create | |