docs

Download

docs@python.org

January 2026

4 participants
2 discussions

(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