Alăturați-vă tendinței de codare socială și contribuiți la GitHub Repositories

Ați găsit vreodată un pachet pe GitHub care v-a plăcut, dar ați dorit să adăugați o caracteristică rapidă, să remediați o eroare pe care ați găsit-o sau poate doar să contribuiți la open source în ansamblu? Alăturați-vă tendinței de codare socială, împărtășiți-vă abilitățile și ajutați să beneficiați lumea open source. În acest articol, aflați totul despre cum să contribuiți la codul într-un depozit pe GitHub sau orice serviciu git găzduit.

Obțineți configurarea

Acest articol presupune că aveți deja un cont GitHub, dar dacă nu, vă rugăm să repede înregistrați-vă pentru un cont gratuit. De asemenea, asigurați-vă că aveți deja git instalat executând următoarea comandă în terminal:

git --versiune

Dacă în loc să vedeți numărul versiunii primiți un mesaj „comanda nu a fost găsită”, puteți instala git cu comanda:

sudo apt-get -y install git

Furcați depozitul

Mai întâi trebuie să alegeți depozitul la care doriți să contribuiți și să îl vizitați în browserul dvs. web. Dacă nu sunteți sigur ce depozit alegeți, puteți utiliza depozitul demo aflat la

https://github.com/mdizak/muo_demo. Aceasta este o demonstrație simplă și sunteți binevenit să creați cereri de extragere împotriva acesteia în scopuri de testare și învățare.

În timp ce vizualizați depozitul în browserul dvs. web, căutați fișierul Depozit de furci și faceți clic pe el. Aceasta va furniza depozitul către propriul dvs. cont GitHub și vă va aduce la acesta. Apoi trebuie clonați depozitul nou furcat, deci deschideți terminalul de pe computerul dvs. local și rulați:

Cum să clonați un depozit utilizând GitHub Desktop

Doriți să faceți cunoștință cu software-ul de pe GitHub? Iată cum puteți ajunge la est cu instrumentul GitHub Desktop simplificat.

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

Bineînțeles, asigurați-vă că schimbați URL-ul de mai sus cu cel al noului depozit. Odată clonat, adăugați depozitul original ca upstream cu comanda:

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

Asigurați-vă că modificați adresa URL din comanda de mai sus cu cea din depozitul original pe care l-ați clonat. Acest lucru semnifică faptul că este un depozit părinte de la care lucrați.

Pregătiți depozitul local

De fiecare dată înainte de a începe să lucrați la o nouă contribuție, asigurați-vă că rulați cea mai recentă bază de cod din depozitul părinte. În directorul proiectului, executați următoarele comenzi în terminal:

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

Prima comandă vă asigură că lucrați în prezent în ramura principală, iar a doua comandă sincronizează depozitul părinte atât cu depozitele locale, cât și cu cele GitHub. Acest lucru vă asigură că modificați cea mai actualizată bază de cod și nu funcționați cu codul învechit.

De asemenea, asigurați-vă că verificați dacă proiectul are un fișier contribution.md și, dacă da, asigurați-vă că urmați ceea ce spune. Uneori, proiectele au orientări specifice cu privire la modul de furnizare a contribuțiilor, care ar trebui întotdeauna respectate.

Creați o filială nouă

Trebuie să creați o nouă ramură care să conțină toate modificările pentru această contribuție, care ulterior vor fi îmbinate în depozitul principal GitHub de către mentenanții proiectului. Ramura trebuie să fie alfanumerică și poate fi numită orice doriți.

Deși nu este necesar, în general se consideră curtoazie obișnuită să se prefixeze numele sucursalei cu remediere rapidă / pentru remedierea rapidă a erorilor sau caracteristică/ pentru funcții adăugate. Alegeți numele sucursalei dorite și executați comanda:

git checkout -b feature / my_cool_feature

Ar trebui să creați întotdeauna o ramură separată pentru fiecare caracteristică / remedierea erorilor și să nu includeți niciodată contribuții multiple într-una. Acest lucru ajută la menținerea unui flux lin de dezvoltare și, de asemenea, vă asigură că contribuția dvs. este acceptată și inclusă în proiect.

Acum că filiala dvs. a fost creată, continuați și completați toate modificările necesare pe care le-ați dori cu fluxul standard de lucru git.

Confirmați și creați o cerere de extragere

Odată ce ați finalizat lucrarea la contribuția dvs., angajați-o cu un mesaj de comitere adecvat și împingeți-l în depozitul dvs. furcat cu comenzile:

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

Ultimul pas este de a crea o cerere de extragere care să avertizeze întreținătorii proiectului că o nouă contribuție este în așteptare. Accesați depozitul GitHub furcat în browserul dvs. web și veți vedea un buton drop-down care vă permite să schimbați sucursalele. Treceți la filiala dvs. recent creată, iar pagina următoare va conține un link care vă permite să creați o nouă cerere de extragere.

După ce faceți clic pe acel link, veți vedea o pagină care afișează mesajul dvs. de confirmare și toate modificările pe care le-ați făcut în cadrul codului. Examinați totul pentru a vă asigura că este corect, adăugați orice mesaj suplimentar necesar pentru întreținători și trimiteți cererea de extragere.

Continuați să contribuiți la GitHub

Felicitări, ați trimis cu succes o contribuție la un proiect GitHub!

Solicitarea dvs. de tragere așteaptă acum revizuirea și aprobarea de către mentenanții proiectului și veți fi notificat prin e-mail dacă a fost sau nu aprobat și cu orice mesaj pe care îl au pentru dvs. Acum că ați învățat cum să contribuiți la proiecte pe GitHub, continuați să mergeți mai departe și ajutați să dezvoltați comunitate open source.

Cum să adăugați mai multă memorie RAM pe dispozitivul dvs. Android cu un card MicroSD

Dacă telefonul sau tableta dvs. Android funcționează puțin încet, s-ar putea să fie nevoie de ceva mai multă memorie RAM. Vă putem ajuta cu asta.

Despre autor