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.
You can also open a discussion item on our Documentation Discourse forum.
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.
- Documentation Translations
A list of GitHub pages for documentation translation and their primary contacts.
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; fewer 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.
- 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.