Message398848
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! |
|
Date |
User |
Action |
Args |
2021-08-03 17:57:31 | jack__d | set | recipients:
+ jack__d, petr.viktorin, docs@python, lukasz.langa, miss-islington |
2021-08-03 17:57:31 | jack__d | set | messageid: <1628013451.93.0.136113039918.issue44756@roundup.psfhosted.org> |
2021-08-03 17:57:31 | jack__d | link | issue44756 messages |
2021-08-03 17:57:31 | jack__d | create | |
|