Nota
¡Ayúdanos a traducir la documentación oficial de Python al Español! Puedes encontrar más información en Como contribuir. Ayuda a acercar Python a más personas de habla hispana.
Lidiar con errores¶
Python es un lenguaje de programación maduro que ha establecido una reputación de estabilidad. Con el fin de mantener esta reputación, a los desarrolladores les gustaría conocer cualquier anomalía que encuentre en Python.
A veces puede ser más rápido corregir errores y añadir parches a Python, ya que agiliza el proceso e involucra a menos personas. Aprenda a contribuir.
Documentación de errores¶
Si encuentras un error en esta documentación o te gustaría proponer una mejora, por favor envía un informe de fallos en el rastreador. Si tienes una sugerencia sobre cómo arreglarlo, inclúyela también.
También puede abrir una discusión en nuestro foro de Documentación de Discourse.
Si tienes poco tiempo, también puedes enviar un correo electrónico con el informe de errores de documentación a la dirección docs@python.org (los errores de comportamiento puedes enviarlos a la dirección python-list@python.org). “docs@” es una lista de correo iniciada por voluntarios; tu petición será notificada, aunque puede que lleve algo de tiempo el ser procesada.
Ver también
- Documentación de errores
Una lista de errores (bugs) que ha sido enviada al issue tracker (sistema de seguimiento de incidentes) de Python.
- Seguimiento de incidencias
Resumen general del proceso necesario para reportar una mejora en el tracker.
- Ayudar con la documentación
Guía detallada para gente interesada en contribuir a la documentación de Python.
- Traducciones de la Documentación
Una lista de páginas de GitHub para la traducción de documentación y sus contactos principales.
Utilizar el issue tracker de Python¶
Los informes de incidencias de Python deben enviarse a través del gestor de incidencias de GitHub (https://github.com/python/cpython/issues). El gestor de incidencias de GitHub ofrece un formulario web que permite introducir la información pertinente y enviarla a los desarrolladores.
El primer paso para completar un informe es determinar si el problema ya ha sido descrito previamente. La ventaja de hacer esto, aparte de ahorrar tiempo a los desarrolladores, es que te permite aprender qué cambios se han realizado para repararlo; puede que el problema se haya reparado para la siguiente versión, o que sea necesaria información adicional (en ese caso, ¡te invitamos a incluirla si puedes!). Para hacerlo, busca en la base de datos de errores usando la zona de búsqueda al principio de esta página.
Si el problema del que informa no está ya en la lista, inicie sesión en GitHub. Si aún no tienes una cuenta en GitHub, crea una nueva a través del enlace «Regístrate». No es posible enviar un informe de error de forma anónima.
Ahora que has iniciado sesión, puedes enviar un informe de error. Haz clic en el botón «New issue» de la barra superior para notificar un nuevo informe de error.
El formulario de envío tiene dos campos: «Title» y «Comment».
En el campo «Title», introduzca una descripción muy breve del problema; menos de diez palabras es suficiente.
En el campo «Comment», describe el problema con detalle, incluyendo qué esperabas que ocurriera y que ha sucedido en realidad. Asegúrate de incluir si cualquier módulo de extensión está involucrado, y qué plataformas de hardware y software estás usando (incluyendo las versiones correspondientes).
Cada informe de error será asignado a un desarrollador que determinará qué es necesario hacer para corregir el problema. Recibirás una actualización cada vez que se tome una medida al respecto.
Ver también
- Cómo informar de errores de manera efectiva
Artículo que detalla cómo crear un informe de errores útil. Describe qué tipo de información es útil y por qué lo es.
- Bug Writing Guidelines
Información sobre cómo escribir un buen informe de errores. Parte de esta información es específica al proyecto Mozilla, pero en general describe buenas prácticas.
Para empezar a contribuir en Python¶
Más allá de informar de los errores que puedas encontrar, te damos la bienvenida a enviar parches para corregirlos. Puedes encontrar más información en cómo empezar parcheando Python en la Python Developer’s Guide. Si tienes preguntas, el core-mentorship mailing list es un agradable lugar para obtener respuestas a cualquiera y a todas las preguntas pertenecientes al proceso de corrección de problemas en Python.