docs September 2021

docs@python.org

10 participants
10 discussions

Re: <documentation>In section 4.6. Defining Functions, It should be print(a,end==' ') in place of print(a, end=' ') (Ruchi Sharma)

by Twinkle Toes

Hi Rushi Sharma, The documentation is correct, it is print(a, end = ‘ ’). The syntax error is from your code. Regards, Lateefah. On Sun, 26 Sep 2021 at 5:35 PM, <docs-request(a)python.org> wrote: > Send docs mailing list submissions to > docs(a)python.org > > To subscribe or unsubscribe via the World Wide Web, visit > https://mail.python.org/mailman3/lists/docs.python.org/ > or, via email, send a message with subject or body 'help' to > docs-request(a)python.org > > You can reach the person managing the list at > docs-owner(a)python.org > > When replying, please edit your Subject line so it is more specific > than "Re: Contents of docs digest..."Today's Topics: > > 1. <documentation>In section 4.6. Defining Functions, It should be > print(a,end==' ') in place of print(a, end=' ') > (Ruchi Sharma) > 2. Re: <documentation>In section 4.6. Defining Functions, It should be > print(a,end==' ') in place of print(a, end=' ') > (Ruchi Sharma) > > > > ---------- Forwarded message ---------- > From: Ruchi Sharma <rohilla.ruchi(a)gmail.com> > To: docs(a)python.org > Cc: > Bcc: > Date: Sat, 25 Sep 2021 22:57:46 +0530 > Subject: [docs] <documentation>In section 4.6. Defining Functions, It > should be print(a,end==' ') in place of print(a, end=' ') > Hi Team, > > I am a beginner in python. I was going through the documentation for the > first time. > > This link: https://docs.python.org/3.8/tutorial/controlflow.html > In section 4.6. Defining Functions, It should be print(a,end==' '). "==" > in place of "=". > Please correct it. Let me correct if I am wrong. > > >>> def fib(n): # write Fibonacci series up to n ... """Print a Fibonacci > series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, end=' ') ... > a, b = b, a+b ... print() ... >>> # Now call the function we just defined: ... > fib(2000) > > Regards, > Ruchi Sharma > > > > > ---------- Forwarded message ---------- > From: Ruchi Sharma <rohilla.ruchi(a)gmail.com> > To: docs(a)python.org > Cc: > Bcc: > Date: Sat, 25 Sep 2021 23:10:46 +0530 > Subject: [docs] Re: <documentation>In section 4.6. Defining Functions, It > should be print(a,end==' ') in place of print(a, end=' ') > In the reference to below email : > print(a, end=' ') > I am getting SyntaxError: invalid syntax after the above line code > Kindly help > > On Sat, 25 Sept 2021 at 22:57, Ruchi Sharma <rohilla.ruchi(a)gmail.com> > wrote: > >> Hi Team, >> >> I am a beginner in python. I was going through the documentation for the >> first time. >> >> This link: https://docs.python.org/3.8/tutorial/controlflow.html >> In section 4.6. Defining Functions, It should be print(a,end==' '). "==" >> in place of "=". >> Please correct it. Let me correct if I am wrong. >> >> >>> def fib(n): # write Fibonacci series up to n ... """Print a >> Fibonacci series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, >> end=' ') ... a, b = b, a+b ... print() ... >>> # Now call the function >> we just defined: ... fib(2000) >> >> Regards, >> Ruchi Sharma >> >> _______________________________________________ > docs mailing list -- docs(a)python.org > To unsubscribe send an email to docs-leave(a)python.org > https://mail.python.org/mailman3/lists/docs.python.org/ >

3 months, 3 weeks

<documentation>In section 4.6. Defining Functions, It should be print(a,end==' ') in place of print(a, end=' ')

by Ruchi Sharma

Hi Team, I am a beginner in python. I was going through the documentation for the first time. This link: https://docs.python.org/3.8/tutorial/controlflow.html In section 4.6. Defining Functions, It should be print(a,end==' '). "==" in place of "=". Please correct it. Let me correct if I am wrong. >>> def fib(n): # write Fibonacci series up to n ... """Print a Fibonacci series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, end=' ') ... a, b = b, a+b ... print() ... >>> # Now call the function we just defined: ... fib(2000) Regards, Ruchi Sharma

3 months, 3 weeks

RFC: New/update the Docs Sphinx theme: responsive, edit page links,

by Wes Turner

Where would be the best place to discuss or just improve the CPython docs sphinx theme? What would Python need in a {PyData,} Sphinx theme fork: - [ ] ENH: add <edit on github> links to every docs page - [ ] ENH: responsive breakpoints for mobile devices - [ ] ENH: responsive fonts - [ ] ENH: toggle-able dark theme - [ ] ENH: interactive code examples (in WASM with pyodide like JupyterLite) - [ ] ENH?: Two sidebars: {Global TOC} {Content} {Document TOC} The PyData theme [bandwagon, feature justification, maintenance burden justification] Src: https://github.com/pydata/pydata-sphinx-theme Docs: https://pydata-sphinx-theme.readthedocs.io/en/latest/ ```quote Other sites that are using this theme: - Pandas: https://pandas.pydata.org/docs/ - NumPy: https://numpy.org/doc/stable/ - SciPy: https://scipy.github.io/devdocs/ - NetworkX: https://networkx.org/documentation/latest/ - Bokeh: https://docs.bokeh.org/en/latest/ - JupyterHub and Binder: https://docs.mybinder.org/, http://z2jh.jupyter.org/en/latest/, https://repo2docker.readthedocs.io/en/latest/, https://jupyterhub-team-compass.readthedocs.io/en/latest/ - Jupyter Book beta version uses an extension of this theme: https://beta.jupyterbook.org - Fairlearn: https://fairlearn.org/main/about/ ``` The sphinx-book-theme theme (Jupyter Book theme) has a few possibly necessary features for the {CPython, Devguide, *} docs: https://github.com/executablebooks/sphinx-book-theme https://sphinx-book-theme.readthedocs.io/en/latest/ :: ```quote A Sphinx theme with a clean design, support for interactive content, and a modern book-like look and feel. Flexible content layout: Inspired by beautiful online books, such as the Edward Tufte CSS guide Visual classes designed for Jupyter Notebooks: Cell inputs, outputs, and interactive functionality are all supported. Launch buttons for online interactivity: For pages that are built with computational material, connect your site to an online BinderHub for interactive content. Bootstrap 4: To style visual elements and add functionality. International: All text integrated in the theme is translated to the specified Sphinx language. ``` https://github.com/python/cpython/blob/main/Doc/conf.py#L68 : ```python html_theme = 'python_docs_theme' ``` https://github.com/python/cpython/blob/main/Doc/requirements.txt#L12 ``` # The theme used by the documentation is stored separately, so we need # to install that as well. python-docs-theme ``` Pypi: https://pypi.org/project/python-docs-theme/ Src: https://github.com/python/python-docs-theme/ What are some better ways to add {Source RST, Source, Edit, History, and Annotate} links to every sphinx doc page than sphinxcontrib-srclinks? https://github.com/westurner/sphinxcontrib-srclinks#usage - sphinxcontrib-srclinks: Source RST, Source, Edit, History, and Annotate, Clone URL - [ ] copy clone URL to clipboard button - pydata-theme: 'Edit this page' on the document TOC sidebar - sphinx-book-theme: {gh, bb, gl} icon > 'Suggest edit' - [ ] ENH: add collapsible sidebar to whatever is chosen as a suitable replacement for the current non-responsive theme

3 months, 3 weeks

Re: Typo in contextvars.Token.old_value (Eric Irrgang)

by Twinkle Toes

Hello all, Has anyone fixed it yet? Regards. On Tue, 14 Sep 2021 at 5:00 PM, <docs-request(a)python.org> wrote: > Send docs mailing list submissions to > docs(a)python.org > > To subscribe or unsubscribe via the World Wide Web, visit > https://mail.python.org/mailman3/lists/docs.python.org/ > or, via email, send a message with subject or body 'help' to > docs-request(a)python.org > > You can reach the person managing the list at > docs-owner(a)python.org > > When replying, please edit your Subject line so it is more specific > than "Re: Contents of docs digest..."Today's Topics: > > 1. Typo in contextvars.Token.old_value (Eric Irrgang) > > > > ---------- Forwarded message ---------- > From: Eric Irrgang <ericirrgang(a)gmail.com> > To: docs(a)python.org > Cc: > Bcc: > Date: Thu, 9 Sep 2021 16:57:52 +0300 > Subject: [docs] Typo in contextvars.Token.old_value > For > https://docs.python.org/3.7/library/contextvars.html#contextvars.contextvar… > and newer, an "is" should be "if". > > Token.old_value says "It points to Token.MISSING is the variable..." > instead of "It points to Token.MISSING if the variable..." > > (Per https://docs.python.org/3/bugs.html#documentation-bugs, I am "short > on time") > Cheers._______________________________________________ > docs mailing list -- docs(a)python.org > To unsubscribe send an email to docs-leave(a)python.org > https://mail.python.org/mailman3/lists/docs.python.org/ >

3 months, 4 weeks

Typo in contextvars.Token.old_value

by Eric Irrgang

For https://docs.python.org/3.7/library/contextvars.html#contextvars.contextvar… and newer, an "is" should be "if". Token.old_value says "It points to Token.MISSING is the variable..." instead of "It points to Token.MISSING if the variable..." (Per https://docs.python.org/3/bugs.html#documentation-bugs, I am "short on time") Cheers.

4 months, 1 week

Thank you.

by Aaron Essilfie

Hi Python Foundation, I'm from Ghana and I chanced on this beautiful pdf from your foundation on the Internet and I want to say thank you. I'm a beginner and I'm glad to have this material. Thank you so much. I want to use python in automation and chemical engineering so it's a great start for me. Thank you. Regards Aaron

4 months, 1 week

Epub version

by trimder＠protonmail.com

The epub version of docs is too big and therefore slow to use comfortably with the average e-reader. Maybe it would be better to split up the documentation into separate parts instead of combining it all together.

4 months, 2 weeks

Python Package documentation error

by Krishna

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

4 months, 2 weeks

Inconsistent documentation for `set.issubset` vs `set.isdisjoint`.

by Jose Ville

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

4 months, 2 weeks

Fwd: Turtle

by David Gillman

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]

4 months, 2 weeks

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

docs September 2021