[issue36838] running 'make html' from the Doc tree emits an unwelcoming error message

Gregory P. Smith added the comment: New changeset 3918ad6b45da31e05265de5a455102276717c659 by Gregory P. Smith in branch 'master': bpo-36838: Suggest 'make venv' when missing Doc/ tools. (GH-13173) https://github.com/python/cpython/commit/3918ad6b45da31e05265de5a455102276717c659 --

[issue36838] running 'make html' from the Doc tree emits an unwelcoming error message

Change by Gregory P. Smith : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed ___ Python tracker ___

[issue36838] running 'make html' from the Doc tree emits an unwelcoming error message

Gregory P. Smith added the comment: I noted this at the mentored sprints this year when I suggested my mentee "cd Doc ; make html" to show them how to build the docs, check that they build and see what they look like. Once upon a time we used to auto-fetch and install sphinx (long ago?), thi

[issue36838] running 'make html' from the Doc tree emits an unwelcoming error message

Change by Gregory P. Smith : -- keywords: +patch pull_requests: +13089 stage: -> patch review ___ Python tracker ___ ___ Python-bug

[issue36838] running 'make html' from the Doc tree emits an unwelcoming error message

Change by Gregory P. Smith : -- assignee: -> gregory.p.smith ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue36838] running 'make html' from the Doc tree emits an unwelcoming error message

New submission from Gregory P. Smith : Running make in the Doc directory does not install all necessary tooling on its own. This is a hurdle to getting beginners up to speed on making documentation changes (often their very first changes in the CPython project). ``` :~/oss/cpython/throwaway: