GitHub ce este și cum se folosește

GitHub este o bucată de software utilizată pe scară largă de echipele de dezvoltare software, pentru controlul versiunilor de dezvoltare.

Este util atunci când mai multe persoane lucrează la un proiect.

De exemplu, să presupunem că o echipă de dezvoltatori de software dorește să construiască un site web și toți trebuie să actualizeze codul, în același timp, în timp ce lucrează la proiect. În acest caz, Github ajută la crearea unui depozit centralizat în care toată lumea poate încărca, edita și gestiona fișiere de cod de program.

Înainte de a începe să utilizați GitHub, trebuie să vă creați un cont GitHub.

Repertoriu

Un depozit este de obicei folosit pentru a organiza un proiect software de aplicație. Arhivele pot conține foldere și fișiere, imagini, videoclipuri, foi de calcul și seturi de date - tot ce are nevoie proiectul tău. Adesea, arhivele includ un fișier README, un fișier cu informații despre proiectul dvs.

Fișierele README sunt scrise în limbajul Markdown în text simplu. Poti consulta această pagină web ca referință rapidă a limbajului Markdown. GitHub vă permite să adăugați un fișier README în același timp în care vă creați noul depozit. GitHub oferă și alte opțiuni comune, cum ar fi un fișier de licență, dar nu trebuie să selectați niciunul inițial.

Pentru a crea un nou depozit, selectați în meniul din dreapta sus New repository. Continuați cu următorii pași:

1. În colțul din dreapta sus al oricărei pagini, utilizați meniul derulant și selectați New repository.

1. În caseta Nume depozit, introduceți first-repository.
2. În caseta Descriere, scrieți o scurtă descriere.
3. Selectați Adăugați un fișier README.
4. Selectați dacă depozitul dvs. va fi public sau privat.
5. Faceți clic pe Create repository.

Crearea unei sucursale

Crearea unei ramuri vă permite să aveți mai multe versiuni ale unui depozit în același timp.

În mod implicitdefinita, depozitul first-repository are o ramură numită main care este considerată ramura definitiv. Puteți crea ramuri suplimentare pentru main în depozit first-repository. Puteți folosi ramuri pentru a avea versiuni diferite ale unui proiect în același timp. Acest lucru este util atunci când doriți să adăugați o nouă funcționalitate unui proiect fără a modifica codul sursă principal. Lucrările efectuate pe diferite ramuri nu vor apărea pe ramura principală până când nu o îmbinați. Puteți folosi ramuri pentru a experimenta și pentru a face modificări înainte de a le trimite în principal.

Când creați o ramură din ramura principală, faceți o copie, sau un instantaneu, a principalului așa cum era în acel moment. Dacă altcineva a făcut modificări în ramura principală în timp ce lucrați la ramura dvs., ați putea împinge aceste actualizări.

În următoarea diagramă putem observa:

Ramura principală
O nouă filială sună feature
Calea pe care feature efectuează înainte de a fi fuzionat cu main

Crearea unei ramuri pentru o nouă implementare sau remediere a erorilor este ca și salvarea unui fișier. Cu GitHub, dezvoltatorii de software folosesc ramuri pentru a menține remedierea erorilor și funcționarea funcțiilor, separat de ramura principală de producție. Când o modificare este gata, aceasta este îmbinată în ramura principală.

Să creăm o ramură

După crearea depozitului nostru, treceți la fila <>Code(1) din depozit:

Faceți clic pe meniul derulant principal (2), apoi dați-i un nume celui nou branch (3)

Click pe Create branch: first branch from 'main'

Acum avem două branch, main e first-branch. Momentan, arată exact la fel. Mai târziu vom adăuga modificările celei noi branch.

Efectuați și confirmați modificări

Tocmai l-am creat pe cel nou branch, GitHub v-a adus la code page pentru noul first-branch, care este o copie a main.

Putem face și salva modificări ale fișierelor din depozit. Pe GitHub, modificările salvate sunt apelate commit. Fiecare commit are un mesaj de la commit asociat, care este o descriere care explică de ce a fost făcută o anumită modificare. Mesajele lui commit ele surprind istoricul schimbărilor, astfel încât alți contribuitori să poată înțelege ce sa făcut și de ce.

Sub ramură first-branch creat, faceți clic pe fișierul README.md, apoi pe creion pentru a edita fișierul.

În editor, scrieți folosind Markdown.

În cutie Commit changes (Previzualizare), scriem un mesaj de commit descriind modificările.

În cele din urmă faceți clic pe butonul Commit changes.

Aceste modificări vor fi făcute numai fișierului README first-branch, așa că acum această ramură conține conținut diferit de cel principal.

Deschiderea unuia pull request

Acum că avem modificări într-o ramură de pe principal, putem deschide una pull request.

Le pull request sunt inima colaborării pe GitHub. Când deschideți un pull request, vă propuneți modificările și solicitați cuiva să facă a review e pull a contribuției dumneavoastră și să le contopiți în ramura lor. The pull request arată diferențele de conținut ale ambelor ramuri. Modificările, adunările și scăderile sunt afișate în culori diferite.

De îndată ce faci un commit, poți deschide o cerere de extragere și poți începe o discuție, chiar înainte ca codul să fie terminat.

Folosind funcția @mention de GitHub în mesajul tău de pull request, puteți cere feedback anumitor persoane sau echipe, indiferent de locația lor.

Puteți chiar să deschideți pull request în depozitul dvs. și îmbinați-le singur. Este o modalitate excelentă de a învăța fluxul GitHub înainte de a lucra la proiecte mai mari.

Pentru a face unul pull request trebuie să:

• Faceți clic pe filă pull request a depozitului dvs first-repository.

• Faceți clic pe New pull request
• In cutie Example Comparisons, selectați filiala pe care ați creat-o, first-branch, pentru a fi comparat cu principal (originalul).
• Examinați modificările aduse diferențelor de pe pagina Comparați, asigurați-vă că acestea sunt cele pe care doriți să le trimiteți.

• Faceți clic pe Create pull request.

• Da-i titlului tau pull request scrieți o scurtă descriere a modificărilor dvs. Puteți include emoji și trageți și plasați imagini și gif-uri.

• Opțional, în dreapta titlului și descrierii, faceți clic pe lângă Recenzători. Destinatari, etichete, proiecte sau etape pentru a adăuga oricare dintre aceste opțiuni la ale dvs pull request. Nu trebuie să le adăugați încă, dar aceste opțiuni oferă mai multe modalități de colaborare folosindu-vă pull request.
• Faceți clic pe Create pull request.

Colaboratorii dvs. vă pot examina acum modificările și vă pot face sugestii.

Îmbină-l pe al tău pull request

În acest pas final, îți vei fuziona ramura first-branch în ramura principală. După comasarea pull request, modificări la ramură first-branch va fi încorporat în fișierul principal.

Uneori, o cerere de extragere poate introduce modificări de cod care intra în conflict cu codul existent pe main. Dacă există conflicte, GitHub vă va avertiza despre codul aflat în conflict și va preveni îmbinarea până când conflictele sunt rezolvate. Puteți efectua un commit care rezolvă conflictele sau puteți utiliza comentariile din cererea de extragere pentru a discuta conflictele cu membrii echipei dvs.

• Faceți clic pe Merge pull request pentru a îmbina modificările în principal.

• Faceți clic pe Confirm merge. Veți primi un mesaj că solicitarea a fost îmbinată cu succes și cererea a fost închisă.
• Faceți clic pe Delete branch. Acum că dvs richiesta pull este fuzionat și modificările dvs. sunt principale, puteți șterge ramura în siguranță first-branch. Dacă doriți să faceți modificări suplimentare în proiectul dvs., puteți oricând să creați o nouă ramură și să repetați acest proces.

Ercole Palmeri