Workflow di fork su GitHub

Immagini di voler contribuire a un progetto open source, ma di non avere l'autorizzazione per modificarne direttamente il codice. È qui che entra in gioco il fork.

Un fork è semplicemente una copia personale del repository GitHub di un'altra persona. Risiede nel proprio account GitHub e offre il pieno controllo per sperimentare e apportare modifiche senza influire sul progetto originale.

Il motivo principale per creare un fork di un repository è proporre modifiche a un progetto quando non si dispone dell'accesso diretto in scrittura al suo codice originale.

• Sperimentazione sicura: lavori sulla propria copia senza il rischio di danneggiare l'originale.
• Percorso per contribuire: è il modo standard per suggerire funzionalità o correzioni nei progetti pubblici.
• Progetti personali: utilizzi un fork come punto di partenza per un proprio progetto correlato.

Creare un fork di un repository su GitHub è molto semplice:

1. Acceda al repository originale di cui desidera creare un fork.
2. Cerchi il pulsante 'Fork', generalmente nell'angolo in alto a destra.
3. Faccia clic sul pulsante 'Fork'. GitHub creerà quindi una copia del repository nel proprio account.

Ora disporrà di github.com/YOUR_USERNAME/ORIGINAL_REPO_NAME.

Dopo aver creato il fork del repository su GitHub, dovrà portare quella copia sul proprio computer per iniziare a lavorarci.

Utilizzi il comando git clone, assicurandosi di clonare l'URL del proprio fork, non quello del repository originale.

Ora che ha clonato il fork localmente, può apportare modifiche proprio come in qualsiasi altro progetto Git. È buona pratica creare un nuovo branch per la funzionalità o la correzione.

Dopo aver eseguito il commit delle modifiche localmente, deve inviarle al fork remoto su GitHub tramite push. In questo modo aggiornerà la propria copia personale del repository.

Il remote origin punta in genere al proprio fork.

Mentre lavora sul fork, il repository originale, spesso chiamato 'upstream', potrebbe ricevere nuovi aggiornamenti. Per mantenere aggiornato il fork, deve sincronizzarlo.

Per prima cosa, aggiunga il repository originale come nuovo remote denominato upstream. Quindi recuperi e integri le relative modifiche.

Una volta completate le modifiche e inviati i commit al fork, è pronto per proporle nuovamente al progetto originale. Questa operazione si esegue tramite una Pull Request (PR).

Su GitHub, acceda al proprio fork. Spesso vedrà un banner che suggerisce di creare una PR dal nuovo branch. Segua le istruzioni per confrontare il branch con il branch principale del repository originale e inviare la proposta.

In sintesi, il tipico flusso di lavoro con i fork è il seguente:

• Fork: crea la propria copia su GitHub.
• Clone: porta il fork sul proprio computer.
• Sviluppo: apporta modifiche in un nuovo branch.
• Push: invia le modifiche al fork remoto.
• Sincronizzazione: mantiene il fork aggiornato con il progetto originale.
• Pull Request: propone le modifiche al progetto originale.

Comprendere perché e come utilizzare un flusso di lavoro basato sui fork è essenziale per collaborare ai progetti open source.

In questa lezione ha imparato a conoscere il flusso di lavoro con i fork di GitHub. Ora sa che un fork crea una copia personale di un repository e consente di contribuire ai progetti anche senza accesso diretto in scrittura.

Abbiamo visto come creare un fork, clonarlo, apportare modifiche, eseguire il push nel fork, sincronizzarlo con il repository upstream e infine creare una Pull Request per proporre i propri contributi. Questo flusso di lavoro è una componente fondamentale dello sviluppo collaborativo su GitHub.