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.
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.
Utilizar el issue tracker de Python¶
Los informes de errores para Python en sí deben enviarse a través de Python Bug Tracker (https://bugs.python.org/). El rastreador de errores ofrece un formulario web que permite ingresar y enviar la información pertinente a los desarrolladores.
El primer paso para rellenar un informe es determinar si el problema ya ha sido descrito previamente. La ventaja de hacer esto, aparte de ahorrar tiempo a los desarrolladores, te permite aprender qué cambios se han realizado para repararlo; puede que el problema se haya reparado para la siguiente publicación, o que sea necesaria información adicional (en ese caso, ¡te damos la bienvenida 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 que estás describiendo no está todavía en el rastreador de errores, vuelve al Python Bug Tracker e inicia sesión. Si no tienes una cuenta en el rastreador, selecciona el enlace «Register» o, si usas OpenID, selecciona uno de los logos de los proveedores OpenID en la barra lateral. No es posible el envío de informes de errores de manera anónima.
Una vez dentro, puedes enviar el error. Selecciona el enlace «Create New» en la barra lateral para abrir el formulario del informe de errores.
El formulario de envío tiene un número de campos. Para el campo «Title», introduce una descripción muy corta del problema; menos de diez palabras está bien. En el campo «Type», selecciona el tipo de problema; selecciona también el «Component» y «Versions» con los que el error está relacionado.
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 errores será asignado a un desarrollador que determinará qué es necesario hacer para corregir el problema. Recibirás una actualización cada vez que una acción nueva sea aplicada.
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.