Mailman 3 May 2025 - docs

Usability of the documentation pages
by Athar, Mohammad (AI&PO) June 1, 2025

June 1, 2025

Dear Python doc team. Even though it's a pleasure to read the official documentation, I am finding that the table of contents is taking up far too much vertical space. Which means it's difficult to get an overall view of the contents. For example, the release notes (What's New in ...) could use collapsible headings to save space. Kind regards Mo Mohammad Athar Solution Architect Capita AI & Product Organisation [cid:dd686c7a-6a79-4a2c-afd6-256aa1bcc11e]

2 1

[Doc Issue] Undocumented changes of LOAD_GLOBAL's stack effect in Python 3.13
by 张三丰 May 27, 2025

May 27, 2025

Hello Python Docs Team, I'm writing regarding Issue #114212 about an undocumented change about bytecode "LOAD_GLOBAL" and "LOAD_ATTR" in the dis module documentation. This issue (https://github.com/python/cpython/issues/114212) was originally opened by sklam on Jan 18, 2024, and it appears that the specific documentation concern remains unresolved in the current Python docs. Sorry for I'm a github new user and don't know how to fix it. Therefore, I send this mail and want to check in and see if there has been any progress. Besides, it seems not easy to understand the change in version 3.12 about instruction relative jumps, and if the documentation included a brief example demonstrating how the CACHE instructions affect relative jumps in bytecode analysis would make this point clearer for readers. For instance, showing a small snippet of bytecode with and without CACHE instructions and how it impacts the instruction offsets would be beneficial. Thank you for your time and for all the work on Python’s documentation. I look forward to hearing from you!

2 1

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

May 27, 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 4

Improve timedelta.seconds docstring to clarify it’s the seconds component, not total seconds
by Maximilien Tirard May 20, 2025

May 20, 2025

Hi Python Docs Team, I recently ran into a tricky bug where I used timedelta(days=60).seconds expecting total seconds, but seconds only returns the seconds component (0–86399), excluding days. This caused my cookie max-age to be zero and cookies to disappear immediately. The current seconds property docstring is just: @property def seconds(self): """seconds”"" which doesn’t explain this behaviour and can be misleading. Could the docstring be improved to clarify that seconds is only the “seconds component” and not total seconds, and that total_seconds() should be used to get the full duration in seconds? Thank you for your hard work and consideration! Best regards, Max

1 0

Python 3.13 Documentation ePub Issue
by Bryan Fegley May 8, 2025

May 8, 2025

Hello, I wanted to report an issue I have encountered. It seems that the ePub version of the Python 3.13 Documentation is corrupt (found here: https://docs.python.org/3/download.html). I get the screenshoted error on every page when I open the book. I’ve tried downloading and opening the file on several different devices and get the same error (Mac, iPhone, iPad, Kindle). Just wanted to bring it to your attention in case this is an issue others might experience as well. I do appreciate the ability to have an epub version of the help docs to keep on my e-reader for referencing on the go. Thank you! Best, Bryan Fegley

3 2