Enhancement: Big obvious download button for https://www.python.org/ftp/python/doc/3.14.0/
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 3/5
- Tiempo estimado
- 1-2 días
- Aptitud para principiantes
- 52/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bastante claro
- Estado de actividad
- Tranquilo
- Stack tecnológico
- python
- Área
- documentation, frontend
Línea de trabajo
Empieza revisando la página de versiones de descargas de Python y la ruta de documentación de FTP enlazada en el issue; después, inspecciona cómo se ofrece actualmente la documentación descargable en python.org. Se considera terminado cuando los principiantes pueden encontrar una ruta destacada a la documentación sin conexión en un formato adecuado, y el destino y los formatos compatibles están claramente verificados.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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
- Lenguaje dominante
- Python
- Estrellas
- 1.7k
- Forks
- 702
- Merge medio
- 1 d 10 h
- PR fusionados (30 d)
- 29
Preparar el entorno
- Incluye un Dockerfile o un archivo de Docker Compose
- Tiene una plantilla de pull request
- Sin guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de python/pythondotorg
-
bug
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
python/pythondotorg#3149 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
app/pages bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
python/pythondotorg#2677 · 3 comentarios ·
Los mantenedores suelen responder en 1 día
-
backend easy
Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100
python/pythondotorg#2453 · 8 comentarios ·
Los mantenedores suelen responder en 1 día
-
Bug: Nominee list shows nominations of you, not nominations you made, and ignores the electionPosiblemente ocupada @jefftriplett la tomó hace 54 días. Abiertobug
Dificultad 3/5 1-2 días Aptitud para principiantes 74/100
python/pythondotorg#3094 · 5 comentarios ·
Los mantenedores suelen responder en 1 día
-
enhancement
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
python/pythondotorg#2996 · 1 comentario ·
Los mantenedores suelen responder en 1 día
Todos los issues de python/pythondotorg
Issues similares
-
area/install reliability
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 83/100
FluidNumerics/fluid-walk-blocker#191 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
TransformerLensOrg/TransformerLens#1868 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
climate-analytics-lab/jax-gcm#1057 ·
Los mantenedores suelen responder en 1 día