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!
È possibile anche aprire un argomento di discussione sul nostro forum Discourse sulla documentazione.
Se dovessi trovare un errore nel tema (HTML / CSS / JavaScript) della documentazione, ti preghiamo di inviare una segnalazione su python-doc-theme bug tracker.
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
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.