Învățarea Git este o abilitate esențială în dezvoltarea de software. Popularitatea tot mai mare a software-ului open-source a dus la succesul Git. Îl puteți folosi pentru a ține evidența contribuțiilor, a gestiona colaborarea și a găzdui baze de cod în arhivele de la distanță.
Git joacă un rol vital în majoritatea proiectelor open-source. Aflați ce relație are Git cu open-source și cum puteți folosi acest instrument productiv pentru a vă spori contribuțiile.
Relația dintre Git și Open-Source
Git este un software de control al versiunilor utilizat pe scară largă în dezvoltare. Git vă permite să urmăriți modificările software în timp real, să salvați copii ale codului dvs. în depozite de la distanță și să colaborați online. Aruncă o privire în profunzime la Git în pagina noastră tutorial Git avansat.
Git este, de asemenea, un proiect open-source la care colaboratorii au lucrat pentru a-l îmbunătăți în timp. Software-ul open-source este, în general, gratuit de utilizat pentru oricine. Software-ul devine open source atunci când proprietarul acordă oricui drepturi de a utiliza, schimba și distribui codul sursă.
Contribuțiile open-source au loc într-o manieră publică și colaborativă, cunoscută și sub numele de „Clădire în public”. Aflați mai multe despre diferența dintre software cu sursă deschisă și cu sursă închisă.
Git are caracteristici de colaborare care sunt esențiale în open source. Git permite echipelor să întrețină proiecte în colaborare. Vă permite să preluați codul, să adăugați contribuții pe computerul dvs. local și să trimiteți modificările pentru examinare.
Caracteristici Git utilizate în Open-Source
Git are mai multe comenzi folosite pentru a efectua operațiuni pe interfața sa. Există multe astfel de comenzi, dar nu trebuie să le înveți pe toate pentru a contribui la open source. Iată câțiva termeni și comenzi de bază pe care le veți întâlni:
- Furculiţă: O copie a unui depozit GitHub (repo). Când faci un furculiţă, primiți o copie a acesteia în contul GitHub, permițându-vă să editați conținutul fără a afecta depozitul părinte al proiectului.
- Emisiune: O idee, eroare sau sarcină la care contribuitorii pot lucra. O problemă cu o etichetă ca bun primul număr este o sarcină simplă menită să motiveze contribuitorii să participe la proiecte open-source.
- Eticheta:Folosit pentru a clasifica probleme și discuții.
- Intretinenti: Colaboratori cu permisiunea de a modifica fișierele din depozitul unui proiect. Sunt cunoscuți și ca proprietari de coduri.
- Colaboratori: Oricine contribuie cu cod, documentație sau alte resurse tehnice la un Proiect.
Următoarele sunt câteva comenzi comune pe care le veți folosi în dezvoltarea open-source:
- Filiala: O copie a conținutului repo. Un repo poate avea mai multe ramuri: ramura principală și alte câteva, dacă este necesar. Ramura implicită este principal/master, și puteți numi ramuri suplimentare în funcție de scopul lor.
- Combina:Merge înseamnă unirea diferitelor ramuri, astfel încât acestea să aibă același cod.
- Solicitare de tragere (PR): Notifică întreținerea că ați introdus cod care trebuie revizuit. Faceți o cerere de extragere atunci când sunteți gata să fuzionați cu filiala părinte și aveți nevoie de recenzii de la alții.
- La distanta: Versiunea online a depozitului dvs. local.
- Preluare: Descarcă conținutul unui depozit de la distanță în depozitul local.
- Angajați: Urmărește modificările unui fișier într-un depozit local sau online. Toate comiterile au un ID unic care înregistrează detalii despre autor, ora și natura modificărilor efectuate.
Noțiuni introductive cu sursa deschisă
În acest tutorial, ne vom uita la pașii de bază pe care îi veți face pentru a vă aduce prima contribuție la open-source. Vom folosi Git ca depozit local și GitHub ca depozit la distanță. Iată cum începi.
1. Alegeți un proiect
Identificați un proiect potrivit la care să contribuiți. Abilitățile și pasiunea dvs. de a face diferența vor determina proiectul pe care îl alegeți. Puteți contribui cu o funcție, documentație sau abilități, cum ar fi managementul produsului.
Proiectul potrivit va avea o comunitate activă pe canalele sociale precum Slack sau Twitter. Depozitul său ar trebui să aibă contribuții regulate și licențiere adecvată pentru software-ul open-source.
2. Obțineți Ghidul pentru colaboratori
Fiecare proiect open-source de renume ar trebui să aibă un ghidul colaboratorilor. Ghidul conține instrucțiuni și instrucțiuni pentru a le arăta noilor dezvoltatori cum să contribuie la proiect.
Veți învăța cum să bifurcați, să lucrați la o problemă și să faceți o cerere de extragere către repo-ul din amonte pentru a permite întreținătorilor să vă revizuiască contribuția. Cel mai probabil veți găsi ghidul colaboratorilor în folderul rădăcină al proiectului.
Ghidul colaboratorilor vă va ajuta să înțelegeți fluxul de lucru al proiectului și să reduceți conflictele de îmbinare. Dacă nu respectați aceste instrucțiuni pentru colaboratori, un întreținător vă poate respinge cerere de tragere.
Iată un exemplu de ghid pentru colaboratori de la AsyncAPI proiect.
3. Alegeți o problemă
Un emisiune poate fi orice la care ai dori să contribui. Poate fi o solicitare pe care ați identificat-o în secțiunea probleme din arhiva proiectului, o greșeală de tipar sau o documentație pe care doriți să o adăugați la proiect.
Înainte de a începe să lucrați la un emisiune, mai întâi întrebați sau discutați despre emisiune cu menţinătorii. Uneori ar putea fi o problemă învechită sau la care un alt colaborator lucrează deja. Iată cum arată secțiunea de probleme de pe GitHub:
4. Lucrați la problema
Odată ce întreținerii aprobă problema, puteți configura un depozit bifurcat. Furking vă va aduce o copie a depozitului părinte în depozitul dvs. Veți clona depozitul în mașina dvs. locală cu clona git comanda.
Puteți deschide folderul în editorul de cod preferat și puteți începe să lucrați. Aici, este esențial să cunoașteți sintaxa lui limbaje de marcare populare, cum ar fi Markdown, care este popular în majoritatea proiectelor open-source. Dacă lucrați la o problemă de documentare, probabil că veți folosi Markdown așa cum este ilustrat mai jos:
5. Trimiteți lucrarea pentru revizuire
Când ați terminat de lucrat la problemă, urmați fluxul de lucru al ghidului colaboratorilor pentru a vă trimite munca la GitHub pentru revizuire. Utilizați următorii pași pentru a configura furca și a o trimite spre examinare.
- Conectați depozitul dvs. local la depozitul din amonte al proiectului utilizând această comandă:
git remote add upstream https://github.com/{original-owner}/{original-repository}.git
- Utilizare git fetch pentru a descărca conținutul sucursalei din amonte în filiala locală:
git branch -u upstream/master master
- Creați o nouă sucursală cu ramură git . Puteți verifica dacă noua ramură este creată cu ramură git comanda.
- Pune-ți în scenă ramura cu git add și comite-o cu git commit -m.
- Împingeți codul în filiala GitHub cu git push origin .
- A face o cerere de tragere(RELATII CU PUBLICUL). Un PR îi alertează pe menținătorii să vă revizuiască filiala și să vă sugereze modificări înainte de fuzionare. Această diagramă rezumă întregul proces.
6. Recenzii și fuziune
După trimiterea PR-ului, menținătorii probabil vor revizui și vor sugera modificări. Puteți face modificări locale sau comite modificările propuse în depozitul de la distanță. GitHub are o prevedere pentru comite se schimba de la distanta.
În timpul revizuirii, veți primi feedback cu privire la contribuția dvs. și puteți solicita clarificări cu privire la unele aspecte. Mai jos este o ilustrare a modului în care puteți efectua modificări pe GitHub:
Când ați terminat de făcut modificări, faceți noi comite. Commits va anunța întreținerii să vă revizuiască din nou munca. Dacă toate verificările trec, PR-ul tău va fi fuzionat rapid. Felicitări! Tocmai ți-ai făcut prima contribuție la un proiect open-source.
Git îmbunătățește colaborarea open-source
Git joacă un rol esențial în contribuțiile open-source. Git permite proiectelor mari și mici să urmărească contribuțiile să gestioneze echipe și să găzduiască diferite versiuni de coduri sursă. Ca proiect open-source în sine, Git a îmbunătățit calitatea și cantitatea contribuțiilor la software-ul open-source.
Prima ta contribuție open-source va fi probabil intimidantă, dar este ușor și distractiv odată ce înveți fluxul de lucru. Folosirea Git vă va ajuta să vă îmbunătățiți abilitățile de codificare, să învățați colaborarea și să vă conectați cu cei mai buni oameni din industria tehnologiei. Haide și începe!