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.

classification
Title: Set documentation: Link to wikipedia
Type: Stage:
Components: Documentation Versions: Python 2.7
process
Status: closed Resolution: wont fix
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, guettli, orsenthil, rhettinger, terry.reedy
Priority: normal Keywords:

Created on 2011-03-11 10:04 by guettli, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (4)
msg130555 - (view) Author: Thomas Guettler (guettli) * Date: 2011-03-11 10:04
A link from 
  http://docs.python.org/library/stdtypes.html#set.union
to
   http://en.wikipedia.org/wiki/Union_%28set_theory%29
would help young people to understand sets.

Of course it is the same for intersection(), difference(), and symmetric_difference().

The images of the wikipedia article explain it very good.
msg130557 - (view) Author: Senthil Kumaran (orsenthil) * (Python committer) Date: 2011-03-11 10:29
Only for relatively uncommon concepts like "Moving Average" and
some other cases used in collections module hyperlink to a general
article helps.

Set theory is a commonly understood concept and link to wikipedia
article may not be required. It can be left to the user to find out
more, if they want.
msg131395 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2011-03-19 05:36
There is no end of helpful articles at Wikipedia and elsewhere. Wikipedia articles are especially easy to find with a special search in some browsers and on the site. In my experience on python-list, for instance, people have much more problem with floats, for instance, than sets. Certainly, sets are taught much better in U.S. schools.
msg131399 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2011-03-19 07:40
I concur with the other respondants.

Also, experience has shown a near zero learning curve for sets.  For whatever reason, people seem to just get it and not require further explanation.
History
Date User Action Args
2022-04-11 14:57:14adminsetgithub: 55674
2011-03-19 07:40:12rhettingersetnosy: + rhettinger
messages: + msg131399
2011-03-19 05:36:40terry.reedysetstatus: open -> closed

nosy: + terry.reedy
messages: + msg131395

resolution: wont fix
2011-03-11 10:29:22orsenthilsetnosy: + orsenthil
messages: + msg130557
2011-03-11 10:04:36guettlicreate