Mailman 3 September 2021 - docs

Python Package documentation error
by Krishna Sept. 3, 2021

Sept. 3, 2021

Hi Python Team, I think the statement "The __init__.py files are required to make Python treat directories containing the file as packages" is wrong in the documentation[1] because it is valid only for Python 2.x version not Python 3.x version. Even though it is good practice to have this file, it is not mandatory to have in Python 3x. to treat directories as packages. So I think we should correct it. [1] https://docs.python.org/3/tutorial/modules.html?highlight=packages#packages Thanks, Krishna

1 0

Inconsistent documentation for `set.issubset` vs `set.isdisjoint`.
by Jose Ville Sept. 2, 2021

Sept. 2, 2021

Hello, In the set documentation <https://docs.python.org/3.7/library/stdtypes.html#set>, it is mentioned: Note, the non-operator versions of union(), intersection(), difference(), > and symmetric_difference(), issubset(), and issuperset() methods will > accept any iterable as an argument. Through some trial, it seems that `isdisjoint() <https://docs.python.org/3.7/library/stdtypes.html#frozenset.isdisjoint>` also accepts any iterable as an argument; however, there is no mention of this in the documentation. The documentation seems to imply that `isdisjoint()` would only accept a set as an argument: set.disjoing(other) Return True if the set has no elements in common with other. Sets are > disjoint if and only if their intersection is the empty set. Perhaps, `isdisjoint()` should be added to the list of set functions which are documented as accepting any iterable as an argument: Note, the non-operator versions of union(), intersection(), difference(), > and symmetric_difference(),* isdisjioint()*, issubset(), and issuperset() > methods will accept any iterable as an argument. > Best, Jose

1 0

Fwd: Turtle
by David Gillman Sept. 2, 2021

Sept. 2, 2021

Dear Python Docs, I hope I'm not spamming you with this proposal. I would like to propose the image below designed by my student as a logo for Python turtle. I believe it has three main virtues to recommend it. It is simple, it is cute, and a student can draw it with Python turtle on the first day, which is in keeping with the pedagogical spirit of Python turtle. Yours truly, David Gillman [he/him] Associate Professor of Computer Science New College of Florida w: 941-487-4118 c: 857-544-3963 ---------- Forwarded message --------- From: Kiera Chase <k.chase25(a)ncf.edu> Date: Wed, Sep 1, 2021 at 5:06 PM Subject: Turtle To: David Gillman <dgillman(a)ncf.edu> [image: Screen Shot 2021-09-01 at 5.03.59 PM.png]

1 0