Come aprire una richiesta pull su GitHub

Una richiesta pull (PR) è una funzionalità di GitHub che ti consente di proporre modifiche a un repository a cui non hai accesso in scrittura. I manutentori del repository possono rivedere queste modifiche e, se lo desiderano, unirle al repository originale.

L’apertura di richieste pull su GitHub è fondamentale per contribuire a progetti open source e collaborare con altri sviluppatori. Scopri come creare e aprire una richiesta pull su GitHub in pochi semplici passaggi.

Passaggio 1: fork del repository

Il fork di un repository sulla piattaforma GitHub crea una copia, altrimenti nota come “fork”, di quel repository, sotto il tuo account. Il fork di un repository consente di apportare modifiche al codice senza influire sul repository originale.

Per eseguire il fork di un repository, vai alla sua pagina principale e fai clic sul pulsante fork nell’angolo in alto a destra:

Inserisci il nome del repository (fork) e una descrizione facoltativa e fai clic su Crea fork :

Ora hai creato una copia del repository originale. Questo nuovo repository ha una connessione con l’originale in modo che qualsiasi modifica apportata al codice possa essere facilmente confrontata e unita nuovamente in esso.

Passaggio 2: apportare modifiche al codice

Dopo aver eseguito il fork del repository, potrebbe essere necessario clonarlo sul computer locale, a seconda della quantità e della natura delle modifiche che si desidera proporre. Se stai apportando modifiche molto semplici che non è necessario testare, puoi farlo online utilizzando l’editor basato su Web GitHub .

Per clonare un repository sul tuo computer locale usando Git, esegui questo comando da terminale:

git clone <REPOSITORY_URL>


Sostituisci <REPOSITORY_URL> con l’URL del tuo repository: puoi trovarlo su GitHub. Questo comando clonerà il repository sul tuo computer locale, dove potrai liberamente sperimentare e apportare modifiche al codice.

Dovresti mantenere le tue modifiche piccole e mirate, poiché le richieste pull di grandi dimensioni possono essere difficili da rivedere e unire. Cerca di mantenere le tue modifiche specifiche per un problema o una caratteristica, per rendere più facile per i manutentori esaminarle e accettarle.

Dopo aver apportato le modifiche desiderate in locale, esegui il commit e inviale al fork di GitHub utilizzando Git.

Passaggio 3: apertura di una richiesta pull

Dopo aver eseguito il commit delle modifiche su GitHub, dovresti visualizzare un messaggio che ti avvisa che il tuo ramo è un numero di “commit” avanti rispetto al repository da cui lo hai biforcato, ad esempio:

Fai clic sul menu a discesa Contribuisci . Facendo clic su questo pulsante verrà richiesto di aprire una richiesta pull. Quindi, fai clic sul pulsante Apri richiesta pull :

Alcuni repository hanno linee guida specifiche per i contributi, che in genere puoi trovare in un file CONTRIBUTING.md, che devi seguire. Assicurati di leggere e seguire queste linee guida prima di inviare una richiesta pull.

Successivamente, compila i campi richiesti e fai clic sul pulsante Crea richiesta pull :

Il tuo messaggio di commit dovrebbe essere chiaro e conciso, descrivendo le modifiche apportate e il ragionamento dietro di esse. Ciò aiuterà i manutentori a comprendere le tue modifiche e renderà loro più facile la revisione del codice.

Una volta creato il pull, dovrai attendere che i manutentori del progetto lo rivedano e lo uniscano o lo chiudano. I manutentori potrebbero avere suggerimenti o feedback sulla tua richiesta pull. Sii aperto ai cambiamenti e disposto a fare revisioni se te lo chiedono.

L’importanza delle richieste pull

Le richieste pull facilitano la collaborazione tra gli sviluppatori consentendo loro di proporre modifiche, fornire feedback e rivedere il codice. Questo aiuta a promuovere un senso di comunità e collaborazione all’interno di un progetto, portando a maggiori contributi e uno sviluppo più rapido.

Inoltre, le richieste pull organizzano la cronologia e il controllo delle versioni del progetto consentendo ai manutentori di tenere traccia delle diverse versioni del codice e delle modifiche apportate a ciascuna versione.