Contribuisci

Ti interessa rendere ghostwriter ancora migliore? Leggi le sezioni seguenti per vedere come puoi contribuire.

Segnalazioni di bug

Trovato un bug? Segnalalo sul sistema di tracciamento dei bug di KDE. Non dimenticare di seguire le linee guida per la segnalazione dei bug! Soprattutto, non dimenticare di includere il numero di versione di ghostwriter che stai utilizzando.

Avviso: la mancata fornitura delle informazioni richieste nel modello di segnalazione dei bug comporterà la chiusura automatica della segnalazione.

Selezione degli errori

Puoi aiutare a classificare i problemi nel sistema di tracciamento dei bug riproducendo i bug e ottenendo maggiori informazioni dai segnalatori di bug per aiutare a restringere dove si trova il problema. Anche la chiusura di problemi duplicati e altri riordini sarebbero apprezzati. Per ulteriori informazioni, consulta le linee guida per la valutazione dei bug.

Nuove funzionalità e correzioni di bug

Sai come programmare? Segui questi passi:

Invia un problema per la tua funzione o bug sul sistema di tracciamento dei bug di KDE.
Nota: questo passaggio è necessario per garantire che la nuova funzionalità soddisfi gli obiettivi del progetto o che il bug non sia realmente una funzionalità. Dovrai anche coordinare quali aree di codice aggiornerai per evitare conflitti di unione nel caso in cui anche qualcun altro stia lavorando su quella stessa area di codice.
Dopo aver discusso del tuo nuovo problema, scrivi il codice della tua funzione o correggi il bug. Segui la guida allo stile di codifica di KDE Frameworks. Importante: Mantieni il tuo codice incentrato sul problema in questione. Le modifiche non correlate al codice appartengono a problemi separati/richieste di unione per semplificare la revisione e il test del codice.
Invia una richiesta di pull sul ramo master con gli aggiornamenti del codice.
Importante: esegui lo squash dei tuoi commit in git prima di inviare la richiesta di pull!
Attendi una breve revisione del codice e almeno altri due volontari per verificare la funzionalità o la correzione di bug.
Aggiorna la tua richiesta di pull quando ricevi riscontro.
Una volta che la tua richiesta di pull è stata approvata da almeno altri due tester volontari, la tua richiesta di pull sarà unita.

Revisioni del codice

Sai come programmare e hai un occhio per i dettagli? Offriti come volontario per la revisione tra pari di nuove richieste di unione!

Cerca una nuova richiesta di unione e aggiungi un commento che ti stai offrendo come volontario per la revisione del codice.
Invia commenti di revisione del codice.
Attendi gli aggiornamenti alla richiesta di unione (se necessario).
Continua a fornire riscontro finché non sei sicuro che il codice sia valido.
Lascia un commento con la tua approvazione della richiesta di unione.
Una volta che almeno due tester volontari hanno inviato la loro approvazione, la richiesta di unione sarà applicata.

Ecco alcuni suggerimenti su cosa cercare nelle revisioni del codice:

Il codice inviato segue lo stile di codifica di Guida allo stile di programmazione di KDE Frameworks?
Il codice è leggibile, con commenti che spiegano eventuali righe non ovvie?
Il codice è «pessimista»? In altre parole, verifica la presenza di valori non validi prima di utilizzarli e gestisce possibili condizioni di errore?
I confronti multipli o le dichiarazioni sono racchiuse tra parentesi all'interno delle affermazioni «if» per prevenire incidenti con l'ordine delle operazioni? Esempi:
```
// Errato
if (a == b || c > d);

// Corretto
if ((a == b) || (c > d));
```

I valori letterali sul lato sinistro dell'operatore «==» impediscono a un errore di battitura con l'operatore «=» di sfuggire all'avviso del compilatore? Esempi:

// Errato
if (variable == 1);

//         Motivo: cosa succede se c'è un errore di battitura? Il compilatore non lo catturerà!
if (variable = 1); // Oops!
// Corretto
if (1 == variable);

//         Motivo: questa volta il compilatore catturerà l'errore di battitura.
if (1 = variable); // Oops!

Test

Offriti volontario per rivedere il codice e provare nuove funzionalità e correzioni di bug! Segui questi passi:

Cerca una nuova richiesta di unione e aggiungi un commento che ti stai offrendo volontario per verificarla.
Crea la richiesta di unione sulla tua piattaforma.
Verifica la funzionalità/correzione di bug e prova a romperla!
Fornisci riscontro sui risultati del test nella richiesta di unione.
Attendi gli aggiornamenti alla richiesta di unione (se necessario).
Continua a provare e fornire riscontro finché non sei sicuro che il codice funzioni.
Lascia un commento con la tua approvazione della richiesta di unione.
Una volta che almeno un altro tester volontario invia la propria approvazione, la richiesta di unione sarà accettata.

Traduzioni

Considera di unirti alla squadra di traduzione di KDE per tradurre le tue applicazioni preferite in altre lingue.

Supporto tecnico

Conosci Linux o compili per MacOS? Sai come risolvere quel problema in cui gli altri continuano a incappare? Le tue risposte alle domande degli utenti e la risoluzione dei problemi nel sistema di tracciamento dei bug di KDE sarebbero molto apprezzate!