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.

  Documentation Translations
     A list of GitHub pages for documentation translation and their
     primary contacts.


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