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

If you find a bug in this documentation or would like to propose an
improvement, please submit a bug report on the issue tracker.  If you
have a suggestion on how to fix it, include that as well.

If the bug or suggested improvement concerns the translation of this
documentation, submit the report to the translation’s repository
instead.

È possibile anche aprire un argomento di discussione sul nostro forum
Discourse sulla documentazione.

If you find a bug in the theme (HTML / CSS / JavaScript) of the
documentation, please submit a bug report on the python-doc-theme
issue tracker.

Vedi anche:

  Documentation bugs
     Un elenco dei bug della documentazione che sono stati inviati al
     sistema di segnalazione dei problemi di Python.

  Issue Tracking
     Panoramica del processo coinvolto nella segnalazione di un
     miglioramento sul tracker.

  Aiutare con la Documentazione
     Guida completa per le persone interessate a contribuire alla
     documentazione di Python.

  Traduzioni della Documentazione
     Un elenco delle pagine GitHub per la traduzione della
     documentazione e i loro contatti principali.


Utilizzo dell'Issue Tracker di Python
=====================================

I report sui problemi di Python stesso devono essere inviati tramite
il sistema di segnalazione dei problemi su GitHub
(https://github.com/python/cpython/issues). Il sistema di segnalazione
dei problemi su GitHub offre un modulo web che consente di inserire e
inviare agli sviluppatori le informazioni pertinenti.

Il primo passo per presentare un report è determinare se il problema è
già stato segnalato. Il vantaggio di farlo, oltre a risparmiare tempo
agli sviluppatori, è scoprire cosa è stato fatto per risolverlo;
potrebbe essere che il problema sia già stato risolto per la prossima
versione, o che siano necessarie ulteriori informazioni (in tal caso
sei invitato a fornirle se puoi!). Per farlo, cerca nel tracker
utilizzando la casella di ricerca in cima alla pagina.

Se il problema che stai segnalando non è già nell'elenco, accedi a
GitHub. Se non hai già un account GitHub, crea un nuovo account
utilizzando il link "Sign up". Non è possibile inviare un report di
bug in modo anonimo.

Essendo ora loggato, puoi inviare un problema. Clicca sul pulsante
"New issue" nella barra superiore per segnalare un nuovo problema.

Il form di invio ha due campi, "Titolo" e "Commento".

Per il campo "Titolo", inserisci una *molto* breve descrizione del
problema; meno di dieci parole è considerato buono.

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

Ogni report del problema verrà esaminato da uno sviluppatore che
determinerà cosa deve essere fatto per correggere il problema.
Riceverai un aggiornamento ogni volta che viene intrapresa un'azione
sul problema.

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.

  Linee Guida per la segnalazione dei *Bug*
     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 in autonomia
=================================================

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.
