[issue26947] Documentation improvement needed

Changes by Cheryl Sabella : -- pull_requests: +1130 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mai

[issue26947] Documentation improvement needed

mPython added the comment: Just to mention that I'm not native speaker, and I'm Django (Python) beginner. I'm very good in C++, Java and in last 12 years read a lot IT documentation. Mentioned sentence was not clear enough for me so I created this ticket. -- __

[issue26947] Documentation improvement needed

Xiang Zhang added the comment: As a non-native speaker, actually I prefer the original one. But both versions lead to no confusion for me. -- ___ Python tracker ___

[issue26947] Documentation improvement needed

Eric V. Smith added the comment: I'm a native speaker, and it's not the greatest sentence. How about: All of Python’s immutable built-in objects (such as numbers, strings and tuples) are hashable. None of its mutable containers (such as lists or dictionaries) are hashable. -- nosy: +e

[issue26947] Documentation improvement needed

Steven D'Aprano added the comment: Xiang Zhang is correct: the original is technically correct. If you read it like this: "All of Python’s immutable built-in objects are hashable, while no mutable containers (such as lists or dictionaries) are [hashable]." it should be clear. But if you have

[issue26947] Documentation improvement needed

Xiang Zhang added the comment: I think the original is OK. Adding "not" means the opposite. -- nosy: +xiang.zhang ___ Python tracker ___ _

[issue26947] Documentation improvement needed

New submission from mPython: On following page: https://docs.python.org/3/glossary.html#term-hashable sentence "All of Python’s immutable built-in objects are hashable, while no mutable containers (such as lists or dictionaries) are." is not complete - probably a word "not" is needed on the en