Unisciti alla tendenza della codifica sociale e contribuisci ai repository GitHub

Hai mai trovato un pacchetto su GitHub che ti è piaciuto, ma volevi aggiungere una funzionalità rapida, correggere un bug che hai trovato o forse semplicemente contribuire all'open source nel suo complesso? Unisciti alla tendenza del social coding, condividi le tue capacità e contribuisci a trarre vantaggio dal mondo open source. In questo articolo, scopri tutto su come aggiungere codice a un repository su GitHub o qualsiasi servizio git ospitato.

Ottieni configurazione

Questo articolo presuppone che tu abbia già un account GitHub, ma in caso contrario, ti preghiamo di farlo rapidamente Registrati per avere un account gratuito. Inoltre, assicurati di averlo già fatto idiota installato eseguendo il seguente comando nel terminale:

git --version

Se invece di vedere il numero di versione viene visualizzato il messaggio "comando non trovato", puoi eseguire l'installazione idiota con il comando:

sudo apt-get -y install git

Fork il repository

Per prima cosa devi scegliere il repository a cui desideri contribuire e visitarlo nel tuo browser web. Se non sei sicuro di quale repository scegliere, puoi utilizzare il repository demo situato in

https://github.com/mdizak/muo_demo. Questa è una semplice demo e puoi creare richieste pull contro di essa a scopo di test e apprendimento.

Durante la visualizzazione del repository nel tuo browser web, cerca il file Repository delle forche e fare clic su di esso. Questo farà il fork del repository sul tuo account GitHub e ti porterà ad esso. Quindi devi clonare il repository appena biforcato, quindi apri il terminale sul tuo computer locale ed esegui:

Come clonare un repository utilizzando GitHub Desktop

Vuoi fare i conti con il software su GitHub? Ecco come farlo est con lo strumento desktop GitHub ottimizzato.

git clone https://github.com/myusername/muo_demo.git
cd muo_demo

Naturalmente, assicurati di modificare l'URL sopra riportato con quello del tuo repository appena biforcato. Una volta clonato, aggiungi il repository originale come upstream con il comando:

git remote add upstream https://github.com/mdizak/muo_demo.git

Assicurati di cambiare l'URL nel comando precedente con quello del repository originale che hai clonato. Ciò significa che git è un repository genitore su cui stai lavorando.

Preparare l'archivio locale

Ogni volta, prima di iniziare a lavorare su un nuovo contributo, assicurati di eseguire il codice di base più recente del repository principale. Nella directory del progetto, esegui i seguenti comandi nel terminale:

git checkout master
git pull upstream master && git push origin master

Il primo comando garantisce che stai attualmente lavorando nel ramo principale e il secondo comando sincronizza il repository principale con entrambi i repository locali e GitHub. Ciò garantisce che stai modificando la base di codice più aggiornata e non stai lavorando con codice obsoleto.

Assicurati anche di controllare se il progetto ha un file contrib.md e, in tal caso, assicurati di seguire quello che dice. A volte i progetti hanno linee guida specifiche su come fornire i contributi, che dovrebbero essere sempre seguite.

Crea un nuovo ramo

È necessario creare un nuovo ramo che conterrà tutte le modifiche per questo contributo, che verrà successivamente unito al repository GitHub principale dai manutentori del progetto. Il ramo deve essere alfanumerico e può essere denominato come preferisci.

Sebbene non sia richiesto, è generalmente considerata una cortesia comune anteporre al nome del ramo hotfix / per rapide correzioni di bug o caratteristica / per funzionalità aggiuntive. Scegli il nome del ramo desiderato ed esegui il comando:

git checkout -b feature / my_cool_feature

Dovresti sempre creare un ramo separato per ogni funzione / correzione di bug e non includere mai più contributi in uno. Questo aiuta a mantenere un flusso di sviluppo regolare e aiuta anche a garantire che il tuo contributo sia accettato e incluso nel progetto.

Ora che il tuo ramo è stato creato, vai avanti e completa tutte le modifiche necessarie che desideri con il flusso di lavoro git standard.

Eseguire il commit e creare una richiesta di pull

Una volta completato il lavoro sul tuo contributo, impegnalo con un file messaggio di commit corretto e inviarlo al tuo repository biforcuto con i comandi:

git commit --file commit.txt
git push -u origin feature / my_cool_feature

L'ultimo passaggio è creare una richiesta pull che avverta i manutentori del progetto che un nuovo contributo è in sospeso. Visita il repository GitHub biforcato nel tuo browser web e vedrai un pulsante a discesa che ti consentirà di modificare i rami. Passa al ramo appena creato e la pagina successiva conterrà un collegamento che ti consentirà di creare una nuova richiesta pull.

Facendo clic su quel collegamento vedrai una pagina che mostra il tuo messaggio di commit e tutte le modifiche apportate all'interno del codice. Rivedi tutto per assicurarti che sia corretto, aggiungi eventuali messaggi aggiuntivi necessari per i manutentori e invia la richiesta pull.

Continua a contribuire a GitHub

Congratulazioni, hai inviato con successo un contributo a un progetto GitHub!

La tua richiesta pull è ora in attesa di revisione e approvazione da parte dei manutentori del progetto e ti verrà notificato via e-mail se è stata approvata o meno e con qualsiasi messaggio che hanno per te. Ora che hai imparato come contribuire ai progetti su GitHub, continua ad andare avanti e aiuta a far crescere il comunità open source.

Come aggiungere più RAM al tuo dispositivo Android con una scheda MicroSD

Se il tuo telefono o tablet Android funziona un po 'lentamente, potrebbe essere necessario solo un po' più di RAM. Possiamo aiutare in questo.

Circa l'autore