Is your feature request related to a problem? Please describe.
I spent ages trying to figure out
- if Python had an easy way to download docs (didn't find it)
- which repo contained the files of Python's docs (looked through whole https://github.com/python, and it turned out it was none of them)
I eventually figured out https://www.python.org/downloads/release/python-3144/ would be the simplest route (too bad it's not a git repo though, don't understand the reason why - or is there a Mercurial repo of this somewhere (which is also hidden)?
I extracted the zip, navigated into Doc directory, ran make venv && make html as instructed, and this got me a static HTML tree without any problems (phew).
make latexpdf instead was failing, so first ran make latex then used for i in $(find -name '*.tex'); do xelatex "$i"; done inside build/latex directory: there was an error, but it still built all 37 PDFs I was expecting, so good.
After attempting to release these in a public repo to help future users like me, looking back at the link I used to download Python's source code I decided to navigate to the root (https://www.python.org/ftp/python) to see if there was anything useful, as there's tonnes of stuff in there with no links on the actual site - and I did!
Describe the solution you'd like
Give beginners an easy way to read up about Python offline and in their preferred format!
This is official documentation which is free and will always be the most authoritative source on Python (not to disregard the quality of Python books, which can ease the learning process).
Basic Example
No response
Describe alternatives you've considered
No response
Drawbacks and Impact
This is one of the first things people need to see on the site, these humble docs are gonna accompany them for the whole of their Python journey!
Additional context
No response
Is your feature request related to a problem? Please describe.
I spent ages trying to figure out
I eventually figured out https://www.python.org/downloads/release/python-3144/ would be the simplest route (too bad it's not a
gitrepo though, don't understand the reason why - or is there a Mercurial repo of this somewhere (which is also hidden)?I extracted the zip, navigated into
Docdirectory, ranmake venv && make htmlas instructed, and this got me a static HTML tree without any problems (phew).make latexpdfinstead was failing, so first ranmake latexthen usedfor i in $(find -name '*.tex'); do xelatex "$i"; doneinsidebuild/latexdirectory: there was an error, but it still built all 37 PDFs I was expecting, so good.After attempting to release these in a public repo to help future users like me, looking back at the link I used to download Python's source code I decided to navigate to the root (https://www.python.org/ftp/python) to see if there was anything useful, as there's tonnes of stuff in there with no links on the actual site - and I did!
Describe the solution you'd like
Give beginners an easy way to read up about Python offline and in their preferred format!
This is official documentation which is free and will always be the most authoritative source on Python (not to disregard the quality of Python books, which can ease the learning process).
Basic Example
No response
Describe alternatives you've considered
No response
Drawbacks and Impact
This is one of the first things people need to see on the site, these humble docs are gonna accompany them for the whole of their Python journey!
Additional context
No response