bpo-33869: Add link to list definition in Glossary list entry#7706
bpo-33869: Add link to list definition in Glossary list entry#7706andresdelfino wants to merge 2 commits intopython:masterfrom
Conversation
| :func:`~abc.register`. | ||
|
|
||
| set | ||
| An unordered collection of distinct :term:`hashable` objects that eases |
There was a problem hiding this comment.
Question: Although it would be handy for newcomers to know some usages of a set, should this be considered part of the definition?
I am refering to this part:
eases duplicate removal and computation of mathematical operations such as intersection and difference.
There was a problem hiding this comment.
That's a pretty good question, actually. It's hard to understand what actually is expected from a set type (not the specific set class) from the docs, as it's mostly mixed with set (class) and frozenset:
https://docs.python.org/3/library/stdtypes.html#set-types-set-frozenset
Perhaps this is something I should ask on python-dev ?
There was a problem hiding this comment.
Thanks folks. Perhaps reorganizing a bit would help:
An unordered collection of distinct :term:`hashable` objects that were introduced in :pep:`218`.
Python provides two built-in set types: set (a :term:`mutable` type), and frozen set (an :term:`immutable` type). See :ref:`types-set`.
There was a problem hiding this comment.
Because of Raymon's comment on the BPO issue, I modified the PR substantially, to the point that it only adds a link, actually 😅
|
I don't see think |
|
Though we didn't accept this PR, thanks for the PR @andresdelfino. I agree with @rhettinger on this particular change. @andresdelfino You've been contributing for a while now 😄 It would be great to have you working on meatier doc issues if you would like. |
https://bugs.python.org/issue33869