Come comportarsi con i bug

Python è un linguaggio di programmazione maturo che ha ottenuto una reputazione di stabilità. Al fine di mantenere questa reputazione, gli sviluppatori saranno contenti di ricevere delle segnalazioni nel caso dovessi trovare eventuali errori in Python.

A volte può essere più veloce correggere da soli i bug e contribuire mediante patch a Python, in quanto questo snellisce il processo e coinvolge meno persone. Impara come fare leggendo: contribute.

Errori nella Documentazione

Se dovessi trovare errori in questa documentazione o desideri proporre un miglioramento, ti preghiamo di inviare una segnalazione su tracker. Se dovessi avere anche un suggerimento su come risolvere il problema, aggiungilo!

Se hai poco tempo a disposizione, puoi anche inviare segnalazioni di errori nella documentazione, via email a docs@python.org (i bug comportamentali possono essere inviati a python-list@python.org). “docs@” è una mailing list gestita da volontari; la vostra richiesta verrà notata, anche se potrebbe volerci un po” di tempo per essere elaborata.

Vedi anche

Documentation bugs

A list of documentation bugs that have been submitted to the Python issue tracker.

Issue Tracking

Overview of the process involved in reporting an improvement on the tracker.

Helping with Documentation

Comprehensive guide for individuals that are interested in contributing to Python documentation.

Utilizzo dell’Issue Tracker di 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.

Nel campo «Commento», descrivi in dettaglio il problema, includendo ciò che ti aspettavi e ciò che è successo. Assicurati di includere se sono stati coinvolti moduli di estensione e quale piattaforma hardware e software stavate utilizzando (incluse le informazioni sulle versioni, se dovesse essere utile).

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.

Vedi anche

Come segnalare efficacemente i bug

Articolo che specifica come creare un’utile segnalazione riguardo un bug. Descrive che tipo di informazione è utile e perché è utile.

Bug Report Writing Guidelines

Informazioni su come scrivere una buona segnalazione di bug. Alcune di queste sono specifiche del progetto Mozilla, ma descrivono le buone pratiche generali.

Come iniziare a contribuire a Python da soli

Oltre a segnalare i bug che trovate, saranno apprezzate anche le eventuali patch per correggerli. Puoi trovare maggiori informazioni su come iniziare ad applicare la patch Python nella Python Developer’s Guide. Se avete domande, la core-mentorship mailing list è un luogo amichevole per ottenere risposte a tutte le domande relative al processo di risoluzione dei problemi in Python.