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
Forking di un repository su la 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 su forchetta pulsante in alto a destra:
Inserire il nome del repository (fork) e una descrizione facoltativa e fare clic Crea forchetta:
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 hai bisogno di testare, puoi farlo online usando l'editor basato sul Web di GitHub.
Per clonare un repository sul tuo computer locale usando Git, esegui questo comando da terminale:
idiota clone
Sostituire 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 usando 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 l'hai biforcato, ad esempio:
Clicca il Contribuire cadere in picchiata. Facendo clic su questo pulsante verrà richiesto di aprire una richiesta pull. Quindi, fare clic su Apri richiesta pull pulsante:
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.
Quindi, compila i campi richiesti e fai clic su Crea richiesta pull pulsante:
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.