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
===================================

Issue reports for Python itself should be submitted via the GitHub
issues tracker (https://github.com/python/cpython/issues). The GitHub
issues tracker offers a web form which allows pertinent information to
be entered and submitted to the developers.

The first step in filing a report is to determine whether the problem
has already been reported.  The advantage in doing so, aside from
saving the developers' time, is that you learn what has been done to
fix it; it may be that the problem has already been fixed for the next
release, or additional information is needed (in which case you are
welcome to provide it if you can!). To do this, search the tracker
using the search box at the top of the page.

If the problem you're reporting is not already in the list, log in to
GitHub. If you don't already have a GitHub account, create a new
account using the "Sign up" link. It is not possible to submit a bug
report anonymously.

Being now logged in, you can submit an issue. Click on the "New issue"
button in the top bar to report a new issue.

The submission form has two fields, "Title" and "Comment".

For the "Title" field, enter a *very* short description of the
problem; less than ten words is good.

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).

Each issue report will be reviewed by a developer who will determine
what needs to be done to correct the problem. You will receive an
update each time an action is taken on the issue.

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.

  Guía para describir un error
     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.
