L'apprendimento di Git è un'abilità essenziale nello sviluppo del software. La crescente popolarità del software open source ha portato al successo di Git. Puoi usarlo per tenere traccia dei contributi, gestire la collaborazione e ospitare codebase in repository remoti.
Git svolge un ruolo fondamentale nella maggior parte dei progetti open source. Scopri quale relazione ha Git con l'open-source e come puoi utilizzare questo strumento produttivo per aumentare i tuoi contributi.
La relazione tra Git e Open-Source
Git è un software di controllo della versione ampiamente utilizzato nello sviluppo. Git ti consente di tenere traccia delle modifiche al software in tempo reale, salvare copie del tuo codice in repository remoti e collaborare online. Dai uno sguardo approfondito a Git nel nostro Tutorial avanzato su Git.
Git è anche un progetto open source su cui i contributori hanno lavorato per migliorare nel tempo. Il software open source è generalmente gratuito per chiunque. Il software diventa open source quando il proprietario concede a chiunque i diritti di utilizzare, modificare e distribuire il codice sorgente.
I contributi open source avvengono in modo pubblico e collaborativo, noto anche come "Building in Public". Ulteriori informazioni sulla differenza tra software open source e closed source.
Git ha funzionalità collaborative che sono essenziali nell'open source. Git consente ai team di gestire i progetti in modo collaborativo. Ti consente di recuperare il codice, aggiungere contributi sul tuo computer locale e inviare le modifiche per la revisione.
Funzionalità Git utilizzate nell'open source
Git ha diversi comandi utilizzati per eseguire operazioni sulla sua interfaccia. Esistono molti di questi comandi, ma non è necessario impararli tutti per contribuire all'open source. Ecco alcuni termini e comandi di base che incontrerai:
- Forchetta: una copia di un repository GitHub (repo). Quando fai un forchetta, ne ottieni una copia sul tuo account GitHub, permettendoti di modificare i contenuti senza influire sul repository principale del progetto.
- Problema: Un'idea, un bug o un'attività su cui i contributori potrebbero lavorare. Un problema con un'etichetta come buon primo numero è un compito semplice inteso a motivare i contributori a partecipare a progetti open-source.
- Etichetta:Utilizzato per classificare problemi e discussioni.
- Manutentori: Collaboratori autorizzati a modificare i file nel repository di un progetto. Sono anche conosciuti come proprietari di codice.
- Contributori: Chiunque contribuisca con codice, documentazione o altre risorse tecniche a un progetto.
Di seguito sono riportati alcuni comandi comuni che utilizzerai nello sviluppo open source:
- Ramo: Una copia del contenuto del repository. Un repository può avere diversi rami: il ramo principale e molti altri, se necessario. Il ramo predefinito è principale/maestroe puoi nominare altri rami in base al loro scopo.
- Unisci:Unisci significa unire diversi rami insieme in modo che abbiano lo stesso codice.
- Richiesta pull (PR): Notifica alla manutenzione che è stato eseguito il push del codice che deve essere rivisto. Effettua una richiesta pull quando sei pronto per unirti al ramo principale e hai bisogno di revisioni da parte di altri.
- A distanza: Versione online del tuo repository locale.
- Andare a prendere: Scarica il contenuto di un repository remoto nel tuo repository locale.
- Commettere: Tiene traccia delle modifiche a un file su un repository locale o online. Tutti i commit hanno un ID univoco che registra i dettagli sull'autore, l'ora e la natura delle modifiche apportate.
Iniziare con l'Open Source
In questo tutorial, esamineremo i passaggi di base che farai per dare il tuo primo contributo all'open-source. Useremo Git come repository locale e GitHub come repository remoto. Ecco come iniziare.
1. Scegli un progetto
Identificare un progetto adatto a cui contribuire. Le tue capacità e la passione per fare la differenza determineranno quale progetto sceglierai. Puoi contribuire con funzionalità, documentazione o competenze come la gestione del prodotto.
Il progetto giusto avrà una community attiva sui canali social come Slack o Twitter. Il suo repository dovrebbe avere contributi regolari e una licenza adeguata per il software open source.
2. Scarica la guida per i contributori
Ogni rispettabile progetto open source dovrebbe avere a guida dei contributori. La guida contiene istruzioni e indicazioni per mostrare ai nuovi sviluppatori come contribuire al progetto.
Imparerai come eseguire il fork, lavorare su un problema e fare una richiesta pull al repository upstream per consentire ai manutentori di rivedere il tuo contributo. Molto probabilmente troverai la guida per i contributori nella cartella principale del progetto.
La guida per i contributori ti aiuterà a comprendere il flusso di lavoro del progetto e a ridurre i conflitti di unione. Se non rispetti queste linee guida per i contributori, un manutentore potrebbe rifiutare il tuo richiesta pull.
Ecco un esempio di una guida per contributori dal AsyncAPI progetto.
3. Scegli un problema
UN problema può essere qualsiasi cosa a cui vorresti contribuire. Può essere una richiesta che hai identificato nella sezione dei problemi nel repository del progetto, un errore di battitura o la documentazione che desideri aggiungere al progetto.
Prima di iniziare a lavorare su un problema, prima informarsi o discutere il problema con i manutentori. A volte potrebbe trattarsi di un problema obsoleto o su cui sta già lavorando un altro collaboratore. Ecco come appare la sezione dei problemi su GitHub:
4. Lavora sul problema
Una volta che i manutentori approvano il problema, puoi configurare un repository biforcuto. Il fork ti porterà una copia del repository principale nel tuo repository. Clonerai il repository nel tuo computer locale con il file clone di git comando.
Puoi aprire la cartella sul tuo editor di codice preferito e iniziare a lavorare. Qui, è essenziale conoscere la sintassi di linguaggi di markup popolari come Markdown, che è popolare nella maggior parte dei progetti open source. Se stai lavorando su un problema di documentazione, probabilmente utilizzerai Markdown come illustrato di seguito:
5. Invia il tuo lavoro per la revisione
Quando hai finito di lavorare sul problema, segui il flusso di lavoro della guida dei contributori per inviare il tuo lavoro a GitHub per la revisione. Utilizzare i passaggi seguenti per configurare il fork e inviarlo per la revisione.
- Connetti il tuo repository locale al repository upstream del progetto usando questo comando:
git remote add upstream https://github.com/{original-owner}/{original-repository}.git - Utilizzo git recupera per scaricare i contenuti del ramo upstream nella tua filiale locale:
git branch -u upstream/master master - Crea un nuovo ramo con ramo git . Puoi verificare se il nuovo ramo è stato creato con ramo git comando.
- Metti in scena il tuo ramo con git add e impegnarlo con git commit -m.
- Invia il tuo codice al ramo GitHub con git push origine .
- Fare un richiesta pull(PR). Un PR avvisa i manutentori di rivedere il tuo ramo e suggerire modifiche prima della fusione. Questo diagramma riassume l'intero processo.
6. Revisioni e fusione
Dopo aver inviato il PR, i manutentori probabilmente esamineranno e suggeriranno modifiche. Puoi apportare modifiche locali o commettere le modifiche proposte sul repository remoto. GitHub ha una disposizione per commettere modifiche da remoto.
Durante la revisione, riceverai un feedback sul tuo contributo e potrai chiedere chiarimenti su alcune questioni. Di seguito è riportato un esempio di come è possibile eseguire il commit delle modifiche su GitHub:
Quando hai finito di apportare modifiche, crea nuovi commit. I commit notificheranno ai manutentori di rivedere nuovamente il tuo lavoro. Se tutti i controlli vengono superati, il tuo PR verrà rapidamente unito. Congratulazioni! Hai appena dato il tuo primo contributo a un progetto open-source.
Git migliora la collaborazione open source
Git svolge un ruolo essenziale nei contributi open source. Git consente a progetti grandi e piccoli di tenere traccia dei contributi, gestire i team e ospitare varie versioni dei codici sorgente. Essendo esso stesso un progetto open source, Git ha migliorato la qualità e la quantità dei contributi al software open source.
Il tuo primo contributo open source sarà probabilmente intimidatorio, ma è facile e divertente una volta appreso il flusso di lavoro. L'uso di Git ti aiuterà ad affinare le tue capacità di programmazione, imparare la collaborazione e fare rete con le persone migliori nel settore tecnologico. Vai avanti e inizia!
