Enhancement: Big obvious download button for https://www.python.org/ftp/python/doc/3.14.0/
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 1.7k
- Forks
- 700
- Avg merge
- 2d 13h
- Merged PRs (30d)
- 11
Description
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
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the Python downloads release page and the FTP documentation path linked in the issue, then inspect how downloadable documentation is currently exposed on python.org. Done means beginners can find a prominent route to offline documentation in an appropriate format, with the destination and supported formats clearly verified.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- documentation, frontend
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 52/100