https://github.com/python/cpython/commit/8f36ce3d509caf5d7b3c41478d7aed0df2c485ce
commit: 8f36ce3d509caf5d7b3c41478d7aed0df2c485ce
branch: 3.15
author: Miss Islington (bot) <[email protected]>
committer: hugovk <[email protected]>
date: 2026-09-26T18:59:23Z
summary:

[3.15] gh-57491: Reduce the EPUB table of contents depth to 2 (GH-158105) 
(#158249)

Co-authored-by: Danishk2445 <[email protected]>

files:
A Misc/NEWS.d/next/Documentation/2026-09-24-10-10-15.gh-issue-57491.UA-2uN.rst
M Doc/conf.py

diff --git a/Doc/conf.py b/Doc/conf.py
index 9bbe94c4781fc9e..60219f48a5967bd 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -471,6 +471,10 @@
 # https://github.com/sphinx-doc/sphinx/issues/12359
 epub_use_index = False
 
+# The default depth of 3 lists over a thousand entries, which makes the
+# table of contents hard to navigate in e-book readers
+epub_tocdepth = 2
+
 # translation tag
 # ---------------
 
diff --git 
a/Misc/NEWS.d/next/Documentation/2026-09-24-10-10-15.gh-issue-57491.UA-2uN.rst 
b/Misc/NEWS.d/next/Documentation/2026-09-24-10-10-15.gh-issue-57491.UA-2uN.rst
new file mode 100644
index 000000000000000..c7c8057776bec4a
--- /dev/null
+++ 
b/Misc/NEWS.d/next/Documentation/2026-09-24-10-10-15.gh-issue-57491.UA-2uN.rst
@@ -0,0 +1,3 @@
+Reduce the depth of the table of contents in the EPUB documentation from
+three levels to two, making it much shorter and easier to navigate in e-book
+readers.

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to