Importante

La traduzione è uno sforzo comunitario you can join. Questa pagina è attualmente tradotta al 79.78%.

1. Una contribuzione passo dopo passo

Nota

Sebbene la documentazione QGIS sia utilizzata per illustrare il processo, tutti i comandi e i passaggi illustrati di seguito si applicano anche al sito Web QGIS.

Se stai leggendo queste righe è certamente perché sei disposto a contribuire a scrivere la documentazione di QGIS e stai cercando un modo per farlo. Sei venuti nel posto giusto, il presente documento ti guiderà attraverso i diversi modi per raggiungere questo obiettivo, mostrandoti i principali passi da seguire, i trucchi che puoi usare e le trappole a cui porre attenzione.

Per qualsiasi aiuto, non esitate a chiedere in un commento sulla segnalazione del problema che state cercando di risolvere o a scrivere alla lista QGIS-community-team. Leggete le informazioni generali sul supporto della comunità QGIS.

Buttiamoci ora nel processo.

I sorgenti della documentazione sono memorizzati usando il sistema di controllo di versione git e sono disponibili su GitHub a https://github.com/qgis/QGIS-Documentation. Una lista di problemi da risolvere e di funzioni da spiegare può essere trovata su https://github.com/qgis/QGIS-Documentation/issues.

Suggerimento

Se sei un contributore alle prime armi e non sai da dove cominciare, potresti essere interessato ad affrontare i nostri «rapporti di benvenuto» <https://github.com/qgis/QGIS-Documentation/contribute>`_.

Ci sono due modi principali, che non si escludono a vicenda, per modificare i file:

  1. Using the GitHub web interface

  2. Using Git command line tools.

1.1. Utilizzo dell’interfaccia web di GitHub

L’interfaccia web di GitHub permette di fare quanto segue:

  • modifica file

  • vedere l’anteprima e fare il commit delle tue modifiche

  • effettuare una richiesta di pull per l’inserimento delle modifiche nel repository principale

  • creare, aggiornare o eliminare rami

Se non hai ancora familiarità con git e con il vocabolario di GitHub, puoi leggere il progetto GitHub Hello-world per imparare alcuni vocaboli e azioni di base che saranno usati di seguito.

Nota

Se stai risolvendo un problema segnalato

Se stai facendo delle modifiche per risolvere un issue, aggiungi un commento al report del problema per assegnarlo a te stesso. Questo impedirà a più di una persona di lavorare sullo stesso problema.

1.1.1. Segnala QGIS-Documentation

Supponendo che tu hai già un GitHub account, devi prima fare il fork dei file sorgenti della documentazione.

Naviga alla pagina QGIS-Documentation repository e clicca sul pulsante githubFork in alto a destra.

Nel tuo account GitHub troverai un repository QGIS-Documentation (https://github.com/1/QGIS-Documentation). Questo repository è una copia del repository ufficiale di QGIS-Documentation dove hai pieno accesso in scrittura e puoi fare modifiche senza influenzare la documentazione ufficiale.

1.1.2. Apportare modifiche

Ci sono diversi modi per contribuire alla documentazione di QGIS. Li mostriamo separatamente qui sotto, ma puoi passare da un processo all’altro senza alcun problema.

Alternativa 1: usa la scorciatoia Modifica su GitHub

Pages on the QGIS documentation website can be edited quickly and easily by clicking on the Edit on GitHub link at the top right of each page, or in the drop-down menu at the bottom of the left sidebar.

  1. Questo aprirà il file nel ramo qgis:master con un messaggio in cima alla pagina che ti dice che non hai accesso in scrittura a questo repo e le tue modifiche saranno applicate a un nuovo ramo del tuo repository.

  2. Fai le tue modifiche. Poiché la documentazione è scritta usando la sintassi reStructureText, a seconda delle tue modifiche, potresti aver bisogno di fare riferimento alle writing guidelines 1.

  3. Once you have finished modifying the file, press Commit changes… and add a short title explaining your changes. You can also provide a more detailed explanation, if necessary.

  4. Press Propose changes, saving the modifications to your repository. This will generate a dedicated branch (patch-xxx) in your repository and the web browser will open the Comparing changes page.

    • If the issue you are addressing does not need any further changes, jump to the Share your changes via Pull Request section below.

    • Se ci sono ulteriori modifiche che vuoi fare prima di inviarle a QGIS, segui questi passi:

      1. Vai al tuo ramo di QGIS-Documentation (https://github.com/<YourName>/QGIS-Documentation)

      2. Click on githubBranch and search for the new patch-xxx branch.

      3. Select it. The githubBranch button will now display Branch: patch-xxx.

      4. Jump down to the Modify files section below.

Alternativa 2: creare un ramo ad hoc nel tuo repository di documentazione

Puoi modificare i file direttamente dal tuo ramo della Documentazione QGIS.

First, make sure that your master branch is up to date with upstream, i.e. qgis/QGIS-Documentation:master branch. To do so:

  1. Vai alla pagina principale del tuo repository, ad esempio https://github.com/<YourName>/QGIS-Documentation. Il ramo master dovrebbe essere attivo con una indicazione se è aggiornato con qgis/QGIS-Documentation:master o no.

    Se ha dei commit in precedenza rispetto al ramo upstream, è meglio usare il precedente shortcut button alternative finché non allinei il tuo ramo master.

    Se ha solo dei commit arretrati:

    1. Expand the Sync fork drop-down menu on the right. You can:

      • Compare the branches and see new changes in the upstream branch you do not yet have in yours

      • Fetch and merge: brings changes from the upstream branch into yours.

    2. Click Fetch and merge: after the process, your branch is mentioned as up to date with qgis/QGIS-Documentation:master.

  2. Click on githubBranch in the upper left corner of your forked QGIS-Documentation repository and enter a unique name in the text field to create a new branch. It is advised that the name of the new branch relates to the problem you intend to fix. Convenient for identifying the branch later.

  3. Press Create branch <branch_name> from master. The githubBranch button should now display branch_name.

  4. You are ready to start new changes on top of your new branch.

Attenzione

Fai le tue modifiche in un ramo ad hoc, mai nel **branch master.

Per convenzione, evita di fare cambiamenti nel tuo ramo master tranne quando unisci le modifiche dal ramo master di qgis/QGIS-Documentation nella tua copia del repository QGIS-Documentation. I rami separati ti permettono di lavorare su più problemi allo stesso tempo senza interferire con altri rami. Se fai un errore puoi sempre cancellare un ramo e ricominciare creandone uno nuovo dal ramo master.

1.1.3. Modificare file

  1. Make sure the branch you want to modify is active: its name is displayed in the top left menu or in the page URL.

  2. Browse the source files to the file that needs modifications.

  3. Press the githubEditPencil Edit this file button.

  4. Update the text following the writing guidelines

  5. Once you have finished modifying the file, press Commit changes… and add a short title explaining your changes. You can also provide a more detailed explanation, if necessary.

  6. Make sure Commit directly to the <branch_name> branch is selected.

  7. Press Commit changes to save your modifications in the branch.

  8. To update or add a new image file:

    1. Browse your branch to the folder of the file to update or add.

    2. Top right, use the Add files ► Upload files menu to select and load files from your drive. You can find hints for formatting an image for the docs at Gestione delle schermate.

    3. If a file of the same name already exists, it gets overwritten.

    4. Commit once again your changes to the target branch.

  9. Repeat the previous steps for any other files that need to be updated to fix the issue.

1.1.4. Condividi le tue modifiche via Pull Request

You need to make a pull request to integrate your changes into the official documentation.

Inizia una nuova richiesta di pull

  1. If you used the Edit on GitHub link, after you commit your changes, GitHub automatically opens a new page comparing the changes you made in your patch-xxx branch to the qgis/QGIS-Documentation:master branch.

  2. In all the cases, the comparing changes page can be reached by going to the «Pull requests» page of your repository and click on New pull request.

Confronta le modifiche

Se vedi due finestre di dialogo, una che dice base:master e l’altra compare:branch_name (vedi figura), questo fonderà solo le tue modifiche da uno dei tuoi rami al tuo ramo master. Per risolvere questo problema clicca sul link compare across forks.

../../_images/githubCompareAcrossForks.png

Fig. 1.8 Se la tua pagina Comparing changes assomiglia a questa, clicca sul link compare across forks.

Dovresti vedere quattro menu a tendina. Questi ti permetteranno di confrontare i cambiamenti che hai fatto nel tuo ramo con il ramo master in cui vuoi fonderti. Essi sono:

  • base fork: il ramo in cui vuoi fondere le tue modifiche

  • base: il ramo della diramazione di base in cui vuoi fondere le tue modifiche

  • head fork: il ramo che ha modifiche che si vogliono incorporare nel ramo base

  • compare: il ramo con tali modifiche

Seleziona qgis/QGIS-Documentation come ramo base con master come base, imposta la diramazione principale al tuo repository <YourName>/QGIS-Documentation, e imposta compare al tuo ramo modificato.

../../_images/githubCreatePullRequestComparison.png

Fig. 1.9 Comparare le modifiche tra qgis/QGIS-Documentation e il tuo repository

Una spunta verde con le parole Able to merge mostra che le tue modifiche possono essere unite alla documentazione ufficiale senza conflitti.

Clicca sul pulsante Create pull request.

Avvertimento

Se vedi githubCantMerge

Questo significa che ci sono conflicts. I file che stai modificando non sono aggiornati con il ramo a cui stai puntando, perché qualcun altro ha fatto un commit che è in conflitto con le tue modifiche. Puoi ancora creare la richiesta di pull, ma devi correggere tutti i conflicts per completare la fusione.

Suggerimento

Sebbene sia stata tradotta, la latest version della documentazione di QGIS è ancora mantenuta e i problemi esistenti sono risolti. Se stai correggendo problemi per una release diversa, cambia base da master al ramo appropriato release_... nei passi di cui sopra.

Descrivi la tua richiesta di pull

A text box will open: fill in a title and any relevant description of the changes you are proposing.

Se questo si riferisce ad un particolare`issue <https://github.com/qgis/QGIS-Documentation/issues>`_, aggiungi il numero del problema ai tuoi commenti. Questo viene fatto inserendo # e il numero del problema (e.g. #1234). Se preceduto da termini come fix o close, il problema in questione verrà chiuso non appena la richiesta di pull verrà inserita.

Aggiungi i link alle pagine di documentazione che stai cambiando.

Clicca su Create pull request.

Rivedere e commentare la richiesta di pull

Come visto in precedenza, chiunque può inviare modifiche alla documentazione attraverso le richieste di pull. Allo stesso modo chiunque può rivedere le richieste di pull con domande e comments. Forse lo stile di scrittura non corrisponde alle linee guida del progetto, la modifica manca di alcuni dettagli importanti o di schermate, o forse tutto sembra perfetto e in ordine. La revisione aiuta a migliorare la qualità del contributo, sia nella forma che nella sostanza.

Per rivedere una richiesta di pull:

  1. Vai alla pagina delle richieste di pull <https://github.com/qgis/QGIS-Documentation/pulls>`_ e clicca sulla richiesta di pull su cui vuoi fare un commento.

  2. In fondo alla pagina troverai una casella di testo dove puoi lasciare commenti generali sulla richiesta di pull.

  3. Per aggiungere commenti su linee specifiche,

    1. Click on githubFilesChanged and find the file you want to comment on. You may have to click on < > Display the source diff to see the changes.

    2. Scorri fino alla linea che vuoi commentare e clicca su githubBluePlus. Questo aprirà una casella di testo che ti permetterà di lasciare un commento.

Commenti specifici sulla linea possono essere pubblicati:

  • come commenti singoli, usando il pulsante Add single comment. Vengono pubblicati man mano. Usalo solo se hai pochi commenti da aggiungere o quando replichi su un altro commento.

  • o come parte di una revisione, premendo il pulsante Avvia una revisione. I commenti non vengono inviati automaticamente dopo la convalida, consentendo di modificarli o cancellarli in seguito, di aggiungere un riassunto dei punti principali della revisione o istruzioni globali riguardanti la richiesta di pull e se approvarla o meno. Questo è il modo più opportuno, perché è più flessibile e consente di strutturare la revisione, modificare i commenti, pubblicare quando si è pronti e inviare un’unica notifica ai follower del repository e non una notifica per ogni commento. Maggiori dettagli <https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request>`_.

../../_images/githubAddLineComment.png

Fig. 1.10 Commentare una linea con un suggerimento di modifica

I commenti di riga possono incorporare suggerimenti che l’autore della richiesta di pull può applicare alla richiesta di pull. Per aggiungere un suggerimento, fai clic sul pulsante githubSuggestions Insert a suggestion in cima alla casella di testo del commento e modifica il testo all’interno del blocco del suggerimento.

Suggerimento

Proferire il commit di suggerimenti alla tua richiesta di pull come un batch

Come autore di una richiesta di pull, quando incorpori direttamente il feedback dei revisori nella tua richiesta di pull, evita di usare il pulsante Commit suggestion in fondo al commento quando hai molti suggerimenti da affrontare e preferisci aggiungerli come un batch commit, cioè:

  1. Passa alla scheda githubFilesChanged

  2. Premi Add suggestion to batch per ogni riformulazione che vuoi includere. Vedrai un contatore che aumenta man mano che vai avanti.

  3. Premi uno qualsiasi dei pulsanti Commit suggestions quando sei pronto ad applicare i suggerimenti alla tua richiesta di pull, e inserisci un messaggio che descriva le modifiche.

Questo aggiungerà tutte le modifiche al tuo ramo come un singolo commit, risultando in una storia più leggibile dei cambiamenti e meno notifiche per i fruitori del repository. Per inciso, procedere in questo modo ti farà anche risparmiare molti clic.

Apportare correzioni

Una nuova richiesta di pull verrà automaticamente aggiunta alla lista delle richieste di pull <https://github.com/qgis/QGIS-Documentation/pulls>`_. Altri redattori e amministratori esamineranno la tua richiesta di pull e potranno dare suggerimenti o chiedere correzioni.

Una richiesta di pull innescherà anche controlli automatici di compilazione (ad esempio, per la formattazione rst, sintassi del codice python), e i report sono visualizzati in fondo alla pagina. Se viene trovato un errore, una croce rossa apparirà accanto al tuo commit. Clicca sulla croce rossa o su Details nella sezione di riepilogo in fondo alla pagina della richiesta di pull per vedere i dettagli dell’errore. Dovrai correggere qualsiasi errore o avvertimento segnalato prima che le tue modifiche siano inviate al repository qgis/QGIS-Documentation.

You can make modifications to your pull request until it is merged with the main repository, either to improve your request, to address requested modifications, or to fix a build error:

  1. Click on the githubFilesChanged tab in your pull request page

  2. Press … menu on the right of the filename that you want to modify, and select Edit file.

  3. The file opens in edit mode; add your modifications and commit.

Qualsiasi modifica aggiuntiva sarà automaticamente aggiunta alla tua richiesta di pull se fai queste modifiche allo stesso ramo che hai presentato nella tua richiesta di pull. Per questo motivo, dovresti apportare modifiche aggiuntive solo se tali modifiche si riferiscono al problema che intendi risolvere con quella richiesta di pull.

Se vuoi risolvere un altro problema, crea un nuovo ramo per quelle modifiche e ripeti i passi di cui sopra.

Un amministratore inserirà il tuo contributo dopo che ogni errore di compilazione è stato corretto e dopo che tu e gli amministratori siete soddisfatti delle tue modifiche.

1.1.5. Eliminare il tuo ramo di fusione

Puoi eliminare il ramo dopo che le tue modifiche sono state incorporate. Cancellare i vecchi rami ti evita di avere rami inutilizzati e superati nel tuo repository.

  1. Naviga al tuo ramo del repository QGIS-Documentation (https://github.com/<YourName>/QGIS-Documentation).

  2. Clicca sulla scheda Branches. Sotto Your branches vedrai una lista dei tuoi rami.

  3. Clicca sull’icona deleteSelected Delete this branch per cancellare qualsiasi ramo indesiderato.

1.2. Usare gli strumenti a riga di comando di Git

L’interfaccia web di GitHub è un modo semplice per aggiornare il repo della documentazione di QGIS con i tuoi contributi, ma non offre strumenti per:

  • raggruppare i tuoi commit e pulire la tua cronologia delle modifiche

  • correggere possibili conflitti con il repo principale

  • costruire la documentazione per testare le tue modifiche

Hai bisogno di install git sul tuo disco rigido per avere accesso a strumenti più avanzati e potenti e avere una copia locale del repository. Alcune nozioni di base di cui potresti avere spesso bisogno sono esposte qui sotto. Troverai anche delle regole a cui badare anche se opti per l’interfaccia web.

Negli esempi di codice qui sotto, le linee che iniziano con $ mostrano i comandi che dovresti digitare, mentre # sono commenti.

1.2.1. Repository locale

Ora sei pronto per ottenere un clone locale del tuo repository QGIS-Documentation.

Puoi copiare il tuo repository QGIS usando l’URL web come segue:

# move to the folder in which you intend to store the local repository
$ cd ~/Documents/Development/QGIS/
$ git clone https://github.com/<YourName>/QGIS-Documentation.git

La prima linea di comando è semplicemente un esempio. Dovresti adattare sia il percorso che l’URL del repository, sostituendo <YourName> con il tuo nome utente github.

Verifica quanto segue:

# Enter the local repository
$ cd ./QGIS-Documentation
$ git remote -v
origin  https://github.com/<YourName>/QGIS-Documentation.git (fetch)
origin  https://github.com/<YourName>/QGIS-Documentation.git (push)
$ git branch
* master

  • origin è il nome del repository remoto del tuo repository QGIS-Documentation.

  • master è il ramo principale di default. Non dovresti mai usarlo per contribuire! **Mai!

In alternativa puoi clonare il tuo repository QGIS usando il protocollo SSH:

# move to the folder in which you intend to store the local repository
$ cd ~/Documents/Development/QGIS/
$ git clone [email protected]:<YourName>/QGIS-Documentation.git

Suggerimento

Errore di autorizzazione negata (chiave pubblica)?

Se ricevi un errore Permission denied (publickey) con il comando precedente, potrebbe esserci un problema con la chiave SSH. Vedere la guida di GitHub per i dettagli.

Verifica quanto segue se hai usato il protocollo SSH:

# Enter the local repository
$ cd ./QGIS-Documentation
$ git remote -v
origin  [email protected]:<YourName>/QGIS-Documentation.git (fetch)
origin  [email protected]:<YourName>/QGIS-Documentation.git (push)
$ git branch
* master

Puoi iniziare a lavorare qui ma nel processo a lungo termine avrai un sacco di problemi quando spingerai il tuo contributo (chiamato Pull Request nel processo di github) come il ramo principale del repository qgis/QGIS-Documentation divergerà dal tuo repository locale/remoto. Devi quindi tenere traccia del repository remoto principale e lavorare con i rami.

1.2.2. Aggiungere un altro repository remoto

Per poter seguire il lavoro nel progetto principale, aggiungi un nuovo repository remoto nel tuo repository locale. Questo nuovo repository remoto è il repository QGIS-Documentation del progetto QGIS:

$ git remote add upstream https://github.com/qgis/QGIS-Documentation.git
$ git remote -v
origin  https://github.com/<YourName>/QGIS-Documentation.git (fetch)
origin  https://github.com/<YourName>/QGIS-Documentation.git (push)
upstream        https://github.com/qgis/QGIS-Documentation.git (fetch)
upstream        https://github.com/qgis/QGIS-Documentation.git (push)

Allo stesso modo, puoi usare il protocollo SSH per aggiungere un repository remoto nel tuo repository locale:

$ git remote add upstream [email protected]:qgis/QGIS-Documentation.git
$ git remote -v
origin  [email protected]:<YourName>/QGIS-Documentation.git (fetch)
origin  [email protected]:<YourName>/QGIS-Documentation.git (push)
upstream        [email protected]:qgis/QGIS-Documentation.git (fetch)
upstream        [email protected]:qgis/QGIS-Documentation.git (push)

Così ora hai la scelta tra due repository remoti:

  • origin per effettuare il push del tuo ramo locale nel tuo repository remoto

  • upstream per fondere (se hai il diritto di farlo) il tuo contributo a quello ufficiale O per aggiornare il tuo ramo master del repository locale dal ramo master del repository ufficiale.

Nota

upstream è solo un’etichetta, una specie di nome standard ma puoi chiamarlo come vuoi.

1.2.3. Aggiornare il tuo ramo base

Prima di lavorare su un nuovo contributo, dovresti sempre aggiornare il ramo master nel tuo repository locale. Supponendo che tu sia disposto ad inviare le modifiche alla documentazione di test, esegui le seguenti linee di comando:

# switch to master branch (it is easy to forget this step!)
$ git checkout master
# get "information" from the master branch in the upstream repository
# (aka qgis/QGIS-Documentation's repository)
$ git fetch upstream master
# merge update from upstream/master to the current local branch
# (which should be master, see step 1)
$ git merge upstream/master
# update **your** remote repository (aka <YourName>/QGIS-Documentation)
$ git push origin master

Ora hai i tuoi repository locali e remoti che hanno entrambi il loro ramo master aggiornato con il ramo ufficiale master di QGIS-Documentation. Puoi iniziare a lavorare sul tuo contributo.

Nota

Cambia il ramo se vuoi contribuire al doc rilasciato

Insieme alla documentazione di test, continuiamo a correggere i problemi nella latest release, il che significa che puoi anche contribuire ad essa. Segui il codice di esempio della sezione precedente, sostituendo master con il ramo corrispondente dell’ultima documentazione.

1.2.4. Contribuire al tuo ramo di produzione

Ora che il tuo ramo base è aggiornato, devi creare un ramo dedicato in cui aggiungere tuoi contributi. Lavora sempre su un ramo diverso da quello di base! Sempre!

# Create a new branch
$ git checkout -b myNewBranch
# checkout means go to the branch
# and -b flag creates a new branch if needed, based on current branch
# Let's check the list of existing branches (* indicates the current branch)
$ git branch
master
release_2.18
...
* myNewBranch
# You can now add your contribution, by editing the concerned file(s)
# with any application (in this case, vim is used)
$ vim myFile
# once done
$ git add myFile
$ git commit

Poche parole sui comandi commit/push:

  • cercare di fare un solo commit (cambiamento atomico), cioè affrontare un solo problema

  • cerca di spiegare attentamente cosa cambi nel titolo del tuo commit e nella descrizione. La prima riga è un titolo e dovrebbe iniziare con una lettera maiuscola e avere una lunghezza di 80 caratteri, non finire con un .. Sii conciso. La tua descrizione può essere più lunga, termina con un . e puoi dare molti più dettagli.

  • usa un # con un numero per riferirti ad un problema. Usa il prefisso Fix se correggi il ticket: il tuo commit chiuderà il ticket.

Ora che le tue modifiche sono salvate e modificate nel tuo ramo locale, hai bisogno di inviarle al tuo repository remoto per creare una richiesta di pull:

$ git push origin myNewBranch

1.2.5. Condividere i tuoi cambiamenti

Ora puoi andare al tuo repository github e create a Pull Request come esposto in una sezione precedente. Assicurati di creare un PR dal tuo ramo al ramo remoto a cui stai puntando nel repository ufficiale di QGIS-Documentation.

1.2.6. Pulire il tuo repository locale e remoto

Dopo che la tua PR è stata fusa nella documentazione ufficiale di QGIS, puoi cancellare il tuo ramo. Se lavori molto in questo modo, in poche settimane avrai un sacco di rami inutili. Quindi mantieni il tuo repository pulito in questo modo:

# delete local branch
$ git branch -d myNewBranch
# Remove your remote myNewBranch by pushing nothing to it
$ git push origin :myNewBranch

E non dimenticare di aggiornare il ramo principale nella tua repository locale!

1.3. Altre letture

  • Oltre all’interfaccia web di Github e agli strumenti a riga di comando git esposti sopra, ci sono anche applicazioni GUI che puoi usare per creare e gestire i tuoi contributi alla documentazione.

  • Quando i cambiamenti nella richiesta di pull sono in conflitto con i recenti cambiamenti inseriti nel ramo di destinazione, i conflitti devono essere risolti prima che una fusione sia possibile:

    • se il conflitto riguarda poche linee concorrenti, nella pagina della richiesta di pull su GitHub è disponibile un pulsante Resolve conflicts. Premere il pulsante e risolvere il problema come spiegato in Resolving a merge conflict on GitHub.

    • se il conflitto riguarda la ridenominazione o la rimozione di file, allora devi risolverlo usando le linee di comando di git. In genere, devi prima eseguire il rebase del tuo ramo sul ramo di destinazione usando la chiamata git rebase targetBranch e correggere i conflitti che vengono segnalati. Per saperne di più: Resolving a merge conflict using the command line

  • A volte, alla fine del processo di revisione, puoi ritrovarti con modifiche suddivise in più commit che non necessariamente sono validi. Le linee di comando di Git aiutano a ridurre questi commit a un numero minore e a messaggi di commit più significativi. Alcuni dettagli su Using git rebase on the command line