This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ned.deily
Recipients Maciej Olko, docs@python, hugovk, ned.deily
Date 2022-03-28.13:47:57
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1648475277.4.0.596377746772.issue47138@roundup.psfhosted.org>
In-reply-to
Content
Thank you both for addressing this. The main reason for minimizing changes to the docs build chain for brances in bugfix or security-fix-only phases is that many distributors of Python also release the Python docs as a package and they do not necessarily rely on using our fairly-recent venv step in the Docs Makefile. In particular, they want to use the versions of Sphinx et al that they release as packages. If we change the required versions for these mid-stream, they not only have to update the docs themselves but have to go through the process of updating the other packages (like Sphinx) which may have other consequences. This can also impact our own on-line doc building process. (Version updates for a new Python feature release prior to its entering beta phase are not a problem.) So it is best to do the minimal amount of version updating for releases in the field, preferably none (as in pinning existing versions). In that spirit, we should also just pin the Jinja2 version for 3.10 and 3.9.
History
Date User Action Args
2022-03-28 13:47:57ned.deilysetrecipients: + ned.deily, docs@python, hugovk, Maciej Olko
2022-03-28 13:47:57ned.deilysetmessageid: <1648475277.4.0.596377746772.issue47138@roundup.psfhosted.org>
2022-03-28 13:47:57ned.deilylinkissue47138 messages
2022-03-28 13:47:57ned.deilycreate