Contribuisci tramite Github

Prerequisiti

Per poter contribuire tramite richieste pull, ci sono diversi prerequisiti:

Saper usare un minimo di Git
Avere un account Github
Avere un fork del progetto su cui si desidera contribuire

Prima di entrare nei dettagli, sarà necessario fare un piccolo appunto sul vocabolario. Ecco un piccolo glossario di parole che usiamo costantemente con Git/GitHub:

repo: Abbreviazione di "Repository". Usiamo questa parola per designare un insieme di file versionati con Git.
ramo: questo è un ramo in un progetto Git. I rami ti consentono di creare una versione parallela del codice ad un certo punto della storia.
master: designa il ramo principale del repository.
origine: designa il repository remoto. Ospitato su Github, per esempio.
pull request: Questa è l'operazione che permette di proporre una modifica del codice ad un progetto su Github.
fork: questo è un repository che è una copia di un altro repository. Questo ti permette di partire da un progetto esistente per modificarlo, migliorarlo, correggerlo o farci qualcos'altro.
upstream: nel caso di un fork, designa il repository da cui proviene il fork.
fetch: è l'operazione che consiste nel recuperare i dati dal remoto in locale.
push: è l'operazione che consente di inviare i dati locali al remoto.

Configurazione

Forchetta

La prima cosa da fare è andare su Github, in modo da creare un fork del progetto a cui si desidera contribuire.

Ad esempio, per contribuire al client Leek Wars, vai qui: Client Leek Wars

Quindi, fai clic sul pulsante "fork" in alto a destra.

Effettuando il "forking" del progetto, Github creerà un nuovo repo sul tuo account. Questa sarà una copia del progetto originale.

Quindi ottieni l'indirizzo del tuo repository github, tramite l'indirizzo url o facendo clic sul pulsante verde "Clona o scarica".

Vai alla posizione in cui vuoi posizionare il tuo repo locale e usa il comando: git clone \ Non dimenticare di sostituire "\".

Ecco. Hai creato un fork del progetto e lo hai recuperato localmente, sulla tua macchina. Ma c'è ancora una cosa da fare per poter continuare ad usarlo senza preoccupazioni in futuro.

A monte

Devi quindi configurare l'upstream, che ti permetterà di aggiornare il tuo repository da quello del progetto.

Il comando git remote -v consente di elencare gli indirizzi remoti configurati.

origine https://github.com/YOUR_USERNAME/YOUR_FORK.git (recupero) origine https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

Per ora, dovresti vedere due indirizzi configurati come origine. One in fetch, quando vuoi rimpatriare nuove funzionalità dal tuo telecomando, il tuo repository ospitato su Github. E l'altro in push che, al contrario, ti consente di inviare le tue notizie locali al repo remoto.

A questo, aggiungeremo l'upstream. Per fare ciò, ottieni l'indirizzo del progetto che hai appena biforcato. Sempre tramite l'url, o il pulsante "Clona o scarica".

Il comando per aggiungere l'upstream è: git remote add upstream \

Se esegui di nuovo il comando git remote -v, ora dovresti vedere quattro voci. Due per l'origine e due per l'upstream. Ognuno duplicato in un fetch e un push.

origine https://github.com/YOUR_USERNAME/YOUR_FORK.git (recupero) origine https://github.com/YOUR_USERNAME/YOUR_FORK.git (push) upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (fetch) upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Sei pronto a contribuire ora!

Rimanere aggiornati

(Passaggio non necessario se hai appena forchetta.)

È probabile che il progetto a cui stai contribuendo non sia scolpito nella pietra. Le persone che se ne prenderanno cura lo faranno evolvere. Altri contributi saranno potenzialmente accettati.

Il tuo repo può quindi diventare rapidamente obsoleto. E questo potrebbe essere un problema.

Se originariamente un file conteneva "A", e vuoi inviare un contributo per cambiare questa "A" in "B". Nel frattempo, forse qualcun altro avrà apportato una modifica da questa "A" a "C".

E quando proponi la tua modifica, ci sarà un conflitto. Impossibile modificare "A" in "B" poiché "A" non è più presente nel file.

Insomma, è importante mantenere aggiornato il repo per evitare spiacevoli sorprese.

Non preoccuparti, ora che hai configurato l'upstream, sarà un gioco da ragazzi!

La prima cosa da fare è ottenere il nuovo m