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 jack__d
Recipients docs@python, jack__d, lukasz.langa, miss-islington, petr.viktorin
Date 2021-08-03.17:57:31
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1628013451.93.0.136113039918.issue44756@roundup.psfhosted.org>
In-reply-to
Content
Actually, I tested out that idea (bpo-44756-doc-make">https://github.com/python/cpython/compare/main...jdevries3133:bpo-44756-doc-make), and I don't think its as nice of a solution. I think it is valuable for new contributors to be able to type "make html" and have it work. Look at how much the change simplifies the README for new contributors to setup their documentation build toolchain. Then, look at how many ``docs@python`` open issues there are. We need documentation contributors, and there is value in simplifying the process for them.

Additionally, this is the extent of the "downloading code from the internet and running it" that occurs::

    pip install -U pip setuptools
    pip install sphynx blurb python-docs-theme

If running that is ever unsafe, we have big problems!
History
Date User Action Args
2021-08-03 17:57:31jack__dsetrecipients: + jack__d, petr.viktorin, docs@python, lukasz.langa, miss-islington
2021-08-03 17:57:31jack__dsetmessageid: <1628013451.93.0.136113039918.issue44756@roundup.psfhosted.org>
2021-08-03 17:57:31jack__dlinkissue44756 messages
2021-08-03 17:57:31jack__dcreate