bneradt opened a new pull request, #12151: URL: https://github.com/apache/trafficserver/pull/12151
This updates Sphinx to version 8 and sphinx-rtd-theme to 3.x. This has the advantage of additional warnings that can catch some of our mistakes and adds support for building on Python 3.13. When considering backporting, note that this requires the docs fixes from #12132. (cherry picked from commit c38cfb23af5d968fa8dea293086778ac81f1c425) --- Doc updates to prepare for Sphinx 8 (#12132) This fixes issues that Sphinx 8 highlights with our footnotes and references. This patch is in preparation of updating to Sphinx 8, which will be in a separate PR. This patch addresses: * The txn-box class-reference.en was referenced from multiple layers of the txn-box toc tree, which Sphinx 8 allerted to being a problem. Sphinx assumes a single parent for each entry in a toc. Before I assume it silently choose one over the other. It seems not needed in dev-guide to me, so I simply removed it from there. * txn_box/misc.en.rst had an unreferenced footnote which this patch removes. * cache-architecture/architecture.en.rst had two broken footnote references because there wasn't a space between the previous word and the footnote. Sphinx requires this space for the footnote to work. (cherry picked from commit dc55e46f10e783235366ed16cca17baa189e1d46) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: github-unsubscr...@trafficserver.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
