Mailman 3 - docs - python.org

(no subject)
by 周博 Jan. 26, 2026

Jan. 26, 2026

I am a Chinese student, and the construction method provided on the download page can only build English documents, not Chinese PDF files, and it is not detailed enough. Can you provide a more detailed tutorial? Is it convenient to build the latest PDF document in Chinese that looks as beautiful as the document you publish locally? Pdf files are indeed very useful in some reading processes. If possible, could you share the latest Chinese PDF file of the Python documentation for 3.13-3.15?

2 1

Python docs: issue with PR 135246
by will.flowers＠gmail.com Jan. 5, 2026

Jan. 5, 2026

Hi, I wanted to share some thoughts about the resolution of a PR and some general concerns I had as a first-time contributor to Python docs. Here's my LinkedIn in case you want to review my technical writing experience: https://www.linkedin.com/in/william-flowers-54038166 The PR was to change the CSV module's introductory text to use a more neutral tone: https://github.com/python/cpython/pull/135246/files This is the primary issue in the original text: > The *so-called CSV (Comma Separated Values) format* is the most common > import and export format for spreadsheets and databases... I thought this was a clear style issue that could be fixed quickly. I made other updates to the subsequent paragraphs for clarity and to accommodate non-English users. In my opinion, all of these align with the Python docs style guide <https://devguide.python.org/documentation/style-guide/#use-simple-language>, but I'm also accustomed to using a stricter style guide and a more corporate-neutral tone. Over the Christmas holiday, the PR was closed by hauntsaninja (see here <https://github.com/python/cpython/pull/135246#issuecomment-3698380152>) because he thought the "commentary" from the first section was necessary to provide context to the subsequent paragraphs. - It was meant to be a simple improvement rather than a substantial improvement. - The opening tone does continue throughout the intro, so the commentary does really tie it together. The intro section as a whole sounds like the author is complaining about *why *he was writing the csv module rather than explaining its usefulness. But I opted to edit rather than remove, which could have exacerbated the issues with this review. So both of his points are technically true, but I think he missed the root issue of why the PR was opened in June 2025. And I get it...maybe my updates were terrible. But it sitting stale for 5 months and being closed on Dec 30th does look very "holiday cleanup chores" to me. I was going to ask for advice on what to do next, but I think that writing this email was the end of the road for me and the so-called CSV format. Thanks for listening, Will Flowers

2 1

ByteString: 3.14 instead of 3.17 in 'Deprecation Timeline of Major Features' section in 'typing' documentation
by Aveyzan Sept. 19, 2025

Sept. 19, 2025

Hello, Python volunteers and employees! I found a bug in the 'typing' library documentation, in the section 'Deprecation Timeline of Major Features'. I realized ByteString is said to be removed in Python 3.17 instead of 3.14, and there is no mention of this change on gh-91806 (https://github.com/python/cpython/issues/91896). If there was conversation about this, I think you should include it in the table, in the 'PEP/Issue' column. Have a nice day! [image: image.png]

2 1

Pdf documentation for Python 3.13.6
by Toby Farrer Aug. 7, 2025

Aug. 7, 2025

I've noticed it in the Python PDF documentation, for version 3.13.6, The archive the archives say they are from a few days ago, but the actual internal PDF files for each topic are still from April. When will new ones be available?

1 0

bug in Decimal
by טל Aug. 6, 2025

Aug. 6, 2025

I think the global get_context().prec is not working since version at the date: Last updated on Aug 06, 2025 (13:19 UTC I noticed my code stopped to work and i tried to navigate between commits but that wasn't the problem... the problem was inside get_context().prec cause i noticed that my Decimals didn't got rounded... i tried to prec = 8 in my config file and it worked well until it didn't and i found out that today you have made an update... so i believe very strong the is something bad in the last update. glad to help and be happier if you will help me too :) thx very much and have a good day :)

1 0

Concern About Inappropriate Content in Teaching Materials
by easyjoy Aug. 2, 2025

Aug. 2, 2025

Dear Python Documentation Team, I am writing to bring to your attention a concerning issue in one of the teaching examples on python.org（Please below attached teaching example and the running result). Specifically, there is content that appears to depict or imply animal cruelty, which is not only inconsistent with ethical standards but also inappropriate for an educational platform used by learners of all ages. Educational materials should promote respect for life and positive values, and such content may undermine that goal. I kindly request that you review the relevant example and consider revising or removing it to align with the principles of kindness and responsibility that are important to the broader community. Thank you for your attention to this matter. I appreciate your commitment to maintaining high-quality, ethical educational resources. Sincerely, Yao Hong The teaching example on python.org The running result:

2 1

Python documentation Simplified Chinese page display error
by mono2681＠outlook.com July 20, 2025

July 20, 2025

The main content on the Simplified Chinese page of the Python documentation is displayed in English instead of Simplified Chinese, while other language versions remain unaffected. I have accessed the Python documentation website in multiple browsers, and the results are as shown in the image below. (The translation from Chinese to English was performed by DeepSeek.) mono2681(a)outlook.com

2 1

EPUB file for 3.13 docs is invalid
by Jayesh Patel July 20, 2025

July 20, 2025

Hi Not sure if this has been raised yet, but the epub file for the 3.13 documentation ( found here https://docs.python.org/3/archives/python-3.13-docs.epub ) cannot be viewed in iBooks, on both iOS and Mac OS. Every page displays the error in the attached screenshot . Apologies if this is not the correct way to raise this issue. If it's not can you please point me in the correct direction. Regards Jayesh

2 1

python-3.14-docs.epub does not render on macOS and iOS
by Christian Clauss July 9, 2025

July 9, 2025

Hello, I am unable to read the Python 3.14 beta 1 in Apple’s Books app on either macOS or iOS. Are others able to read it? https://docs.python.org/3.14/archives/python-3.14-docs.epub Thanks for all your great work. Christian Clauss

3 5

Broken download links for 3.11 docs
by Henrik Tunedal July 7, 2025

July 7, 2025

Hi, I was trying to download the docs for Python 3.11 and noticed that all the download links were broken: https://docs.python.org/3.11/download.html The problem seems to be that the links go to version 3.11.12 but the latest files that exist are for 3.11.11. /Henrik

2 1