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.</contributing-to-python>.


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 en cómo arreglarlo, inclúyela también.

Si tienes poco tiempo, también puedes enviar un correo 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 e-mail 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 en el rastreador de problemas de Python


Utilizar el rastreador de problemas de Python
=============================================

Los informes de errores para Python deben enviarse mediante el Python
Bug Tracker (https://bugs.python.org/).  El rastreador de errores
ofrece un formulario Web donde se puede introducir 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 harware 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 Report 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.
