Not really having read the whole story here, just wanna say that Wikipedia articles already suffer from a tug-of-war between professionals and students. Don’t worsen the problem. Include lay explanation and go into the technical details in a natural progression. Don’t force the reader to make large perspective jumps or conceptual jumps or require them to approach the article from the perspective of the designer from one sentence to the next. Pick your audience first, then write. Wikipedia requires a bridge between student and professional. Write it like it’s a synopsis that goes into detail, not like a reference manual for the already-initiated reader. If you like to write like it’s a reference, then there are list metapages on Wikipedia that tend to be agreeable to this.
peace Sent from Mail for Windows 10 From: Spencer Graves Sent: Tuesday, October 16, 2018 1:06 PM To: Léo El Amri; python-list@python.org Subject: Wikipedia on Python Thanks to Léo El Amri and Thomas Jollans for their quick and helpful replies to my question about "Package creation documentation". Beyond that, I'd like to encourage people on this list to review the Wikipedia article on "Python (programming language)",[1] especially the claim that "a package is a Python module with an __path__ attribute", which I added on 2018-09-24 to help me understand the distinction. That Wikipedia article has averaged over 6,000 views per day over the past 3 years. Therefore, any improvements will benefit lots of people. If you have suggestions for how the article might be improved, you can post them to the "Talk" page associated with that article or send them to me. If you are "autoconfirmed" with the Wikimedia system, you can make the changes yourself. Thanks, Spencer Graves [1] https://en.wikipedia.org/wiki/Python_(programming_language) On 2018-10-16 11:14, Léo El Amri wrote: > Hello Spencer, > > On 16/10/2018 17:15, Spencer Graves wrote: >> Where can I find a reasonable tutorial on how to create a Python >> package? > IMO, the best documentation about this is the tutorial: > https://docs.python.org/3/tutorial/modules.html#packages > >> According to the Python 3 Glossary, "a package is a Python module >> with an __path__ attribute."[1] > What you are looking at are the technical details of what a package is. > Incidentally, if you follow the tutorial, everything will get in-place. > >> I found "packaging.python.org", which recommends "Packaging Python >> Projects"[2] and "An Overview of Packaging for Python".[3] > packaging.python.org is centered on "How to install and distribute > Python packages (Or modules)" > > - Léo > -- https://mail.python.org/mailman/listinfo/python-list -- https://mail.python.org/mailman/listinfo/python-list
