Una guía práctica y multilingüe para estudiar Python, comprender cómo se conectan sus partes y aplicar los conceptos mediante ejemplos claros.
Este proyecto está diseñado como una ruta de aprendizaje y también como una biblioteca de consulta rápida. En lugar de presentar comandos aislados, cada tema explicará qué hace un recurso, por qué existe, cuándo utilizarlo, cuándo evitarlo y cómo funciona junto con otras partes de Python.
Los nombres de carpetas, archivos, variables, funciones, clases y otros identificadores están escritos en inglés. Esto ayuda a quienes están aprendiendo a familiarizarse con convenciones comunes en bibliotecas, documentación técnica y proyectos internacionales.
Las explicaciones estarán disponibles en inglés, portugués de Brasil y español.
Cada capítulo seguirá una estructura consistente:
- Qué es
- Por qué existe
- Sintaxis
- Cuándo utilizarlo
- Cuándo evitarlo
- Cómo se conecta con otros recursos
- Ejemplo básico
- Ejemplo práctico
- Errores comunes
- Ejercicio
- Resumen de consulta rápida
La guía crecerá desde los fundamentos de Python hasta funciones, documentación, manejo de errores, archivos, biblioteca estándar, bibliotecas externas, pruebas y proyectos prácticos.
El árbol siguiente destaca los principales directorios de aprendizaje y soporte. Los documentos detallados de estructura también muestran los archivos de gobernanza y los capítulos internos ya disponibles.
python-study-guide/
├── assets/
├── comments-and-documentation/
├── docs/
├── exercises/
├── external-libraries/
├── functions/
├── fundamentals/
├── practical-projects/
├── scripts/
├── standard-library/
└── tests/
Explicaciones detalladas:
La base del proyecto está completada. La Fase 0 estableció la documentación multilingüe, el flujo de contribución, las plantillas de colaboración, los estándares de la comunidad, la autoría, la licencia, la gobernanza de IA, las validaciones automáticas, la identidad visual original, la estructura escalable del repositorio y la auditoría final de la base. El desarrollo de la ruta puede continuar ahora desde la Fase 1, mientras la sección piloto de la Fase 6 permanece en progreso.
El primer capítulo completo de aprendizaje, Comentarios en Python, ya está disponible. Su sección está organizada y continuará más adelante con docstrings, nombres significativos, marcadores de tareas, comentarios frente a logging y legibilidad según PEP 8. Consulta el roadmap para seguir el estado actual de todas las fases.
El símbolo del proyecto conecta Python, código, aprendizaje y relaciones entre conceptos mediante una serpiente geométrica, llaves, un libro abierto y nodos conectados.
Consulta la guía de identidad visual para conocer los archivos disponibles, la paleta, los significados, las orientaciones de accesibilidad y las reglas de uso.
Este proyecto utiliza herramientas de inteligencia artificial, incluidas ChatGPT y Codex, para apoyar la planificación, la investigación, la redacción, la traducción, la revisión y el mantenimiento del repositorio.
El contenido producido por IA no se acepta automáticamente. Cada cambio debe ser comprendido, verificado y revisado por la persona responsable del proyecto antes de incorporarse a la rama main.
Las instrucciones generales de trabajo para agentes de IA y colaboradores están registradas en AGENTS.md.
Lee la guía de desarrollo asistido por IA para aprender a escribir prompts útiles, transformar una conversación en ChatGPT en un brief de implementación para Codex, revisar el trabajo generado y proteger información privada.
Python Study Guide fue creado y es mantenido por Ramon Estevez Rodriguez.
Las contribuciones de la comunidad son bienvenidas y permanecen reconocidas en los metadatos de los commits, el historial de Git y los pull requests. Consulta el registro de autoría del proyecto para conocer la política completa de atribución.
La participación se rige por el Código de Conducta. La Guía de Soporte explica qué canal corresponde a cada pregunta o solicitud. Las posibles vulnerabilidades deben seguir el proceso privado de la Política de Seguridad, no una issue pública.
Las contribuciones, correcciones, ejemplos y mejoras de traducción son bienvenidas. Lee la guía de contribución en español antes de abrir un pull request. También están disponibles las versiones en inglés y portugués.
Este proyecto está disponible bajo la Licencia MIT.