Ce este bifurcarea?

Când iubim depozitul cuiva și ne-ar plăcea să-l avem în contul nostru GitHub, îl furnizăm astfel încât să putem lucra cu el separat.

Când furnizăm un depozit, obținem o instanță a întregului depozit cu întregul său istoric. După bifurcare, putem face orice vrem să facem fără a afecta versiunea originală.

Ce este o cerere de tragere?

Solicitările Pull sunt modul în care contribuim la proiectele de grup sau la proiectele open source.

De exemplu, un utilizator Harry folosește un depozit de ThanoshanMV și face modificări în depozitul respectiv. Acum Harry poate face o cerere de atragere către ThanoshanMV, dar depinde de ThanoshanMV să o accepte sau să o refuze. Este ca și cum ai spune „ThanoshanMV, te rog să trimiți modificările mele?”

Ce înseamnă să contribui

Nu numai că putem contribui la un proiect open source cu cod, dar putem contribui și în multe alte moduri. Unele dintre aceste moduri sunt descrise mai jos.

La fel de 99tehnologie Ghidul de pornire al hacktitudinii firmei IT spune că putem contribui la un proiect open source în următoarele moduri:

  1. Proiectare: puteți construi aspectele unui proiect pentru a-i îmbunătăți utilizabilitatea, pentru a îmbunătăți navigarea și meniul proiectului pe baza programelor de cercetare ale utilizatorilor, pentru a crea artă pentru logo-uri sau tricouri și pentru a oferi ghiduri de stil pentru proiect.
  2. Scriere: puteți scrie și îmbunătăți documentația proiectului sau traduce documentația, puteți începe un buletin informativ pentru proiect sau puteți scrie tutoriale pentru proiect și puteți selecta elementele din lista de corespondență sau puteți selecta un folder cu exemple care arată modul în care sunt utilizate proiectele.
  3. Organizarea: puteți conecta problemele duplicate, puteți sugera etichete noi, puteți sugera închiderea unor vechi probleme deschise și puteți pune întrebări cu privire la problemele deschise recent pentru a avansa discuția.
  4. Ajutați-i pe ceilalți: răspundeți la întrebări cu privire la problemele deschise, examinați codul despre trimiterile altor persoane și oferiți un mentor unui alt contribuitor.
  5. Codificare: ajutați la rezolvarea oricăror probleme deschise, întrebați dacă puteți oferi funcții noi și îmbunătățiți instrumentele și testarea.

Să facem prima noastră cerere de tragere!

Dacă nu sunteți foarte familiarizați cu Git & GitHub, vă rugăm să revedeți Ghidul pentru începători la Git & GitHub.

1. Furcați depozitul

Furcați depozitul făcând clic pe butonul furcă din partea de sus a paginii. Aceasta va crea o instanță a întregului depozit în contul dvs.

Cum sa faci prima cerere de extragere pe GitHub

2. Clonați depozitul

Odată ce depozitul se află în contul dvs., clonați-l pe computerul dvs. pentru a lucra cu acesta la nivel local.

Pentru a clona, ​​faceți clic pe butonul de clonare și copiați linkul.

1611597486 223 Cum sa faci prima cerere de extragere pe GitHub

Deschideți terminalul și executați următoarea comandă. Acesta va clona depozitul local.

$ git clone [HTTPS ADDRESS]
1611597486 486 Cum sa faci prima cerere de extragere pe GitHub

Acum am creat o copie a ramurii principale din depozitul principal de proiecte online.

Trebuie să mergem la acel director clonat executând această comandă:

$ cd [NAME OF REPOSITORY]
1611597486 156 Cum sa faci prima cerere de extragere pe GitHub

3. Creați o ramură

Este o bună practică să creați o ramură nouă atunci când lucrați cu depozite, indiferent dacă este vorba de un proiect mic sau contribuind la munca unui grup.

Numele sucursalei ar trebui să fie scurt și ar trebui să reflecte munca pe care o facem.

Acum creați o ramură folosind git checkout comanda:

$ git checkout -b [Branch Name]
1611597486 832 Cum sa faci prima cerere de extragere pe GitHub

4. Faceți modificări și comiteți-le

Faceți modificări esențiale proiectului și salvați-l.

Apoi executați git status și veți vedea modificările.

1611597486 936 Cum sa faci prima cerere de extragere pe GitHub

Adăugați aceste modificări la ramura pe care tocmai ați creat-o folosind git add comanda:

$ git add .
1611597486 843 Cum sa faci prima cerere de extragere pe GitHub

Acum comiteți aceste modificări folosind git commit comanda:

$ git commit -m "Adding an article to week 02 of articles of the week"
1611597486 421 Cum sa faci prima cerere de extragere pe GitHub

5. Apăsați modificările la GitHub

Pentru a împinge modificările la GitHub, trebuie să identificăm numele telecomenzii.

$ git remote
1611597486 871 Cum sa faci prima cerere de extragere pe GitHub

Pentru acest depozit, numele telecomenzii este „origine”.

După identificarea numelui telecomenzii, putem împinge în siguranță aceste modificări la GitHub.

git push origin [Branch Name]
1611597486 510 Cum sa faci prima cerere de extragere pe GitHub

6. Creați o cerere de extragere

Accesați depozitul dvs. de pe GitHub și veți vedea un buton „Comparați și trageți cererea” și faceți clic pe el.

1611597486 756 Cum sa faci prima cerere de extragere pe GitHub

Vă rugăm să furnizați detaliile necesare despre ceea ce ați făcut (Puteți face referire la probleme folosind „#”). Acum trimiteți cererea de extragere.

Felicitări! Ați făcut prima cerere de tragere.

1611597486 324 Cum sa faci prima cerere de extragere pe GitHub

Dacă cererea dvs. de extragere este acceptată, veți primi un e-mail.

7. Sincronizați ramul principal bifurcat

Înainte de a trimite orice solicitare de extragere la depozitul original, trebuie să vă sincronizați depozitul cu cel original.

Chiar dacă nu intenționați să trimiteți o cerere de extragere la depozitul original, este mai bine să vă sincronizați cu depozitul original, deoarece s-ar fi putut face unele funcții suplimentare și remedieri de erori de când ați furnizat depozitul original.

Urmați acești pași pentru a actualiza / sincroniza aceste modificări la filiala dvs. principală:

  1. Mai întâi, verificați în ce ramură vă aflați.
$ git branch
1611597486 571 Cum sa faci prima cerere de extragere pe GitHub

Va afișa toate ramurile și indică ramura curentă sau activă în verde.

2. Comutați la ramura principală.

$ git checkout master
1611597486 643 Cum sa faci prima cerere de extragere pe GitHub

3. Adăugați depozitul original ca depozit în amonte.

Pentru a trage modificările din depozitul original în versiunea dvs. furcată, trebuie să adăugați depozitul Git original ca depozit în amonte.

$ git remote add upstream [HTTPS]

Aici, [HTTPS] este adresa URL pe care trebuie să o copiați din depozitul proprietarului.

1611597486 276 Cum sa faci prima cerere de extragere pe GitHub
1611597486 824 Cum sa faci prima cerere de extragere pe GitHub

4. Aduceți depozitul.

Preluați toate modificările din depozitul original. Angajările către depozitul original vor fi stocate într-o ramură locală numită upstream / master.

$ git fetch upstream
1611597487 704 Cum sa faci prima cerere de extragere pe GitHub

5. Îmbină-l.

Îmbinați modificările din upstream / master în ramura master locală. Acest lucru va aduce ramul principal al furcii dvs. în sincronizare cu depozitul din amonte, fără a vă pierde modificările locale.

$ git merge upstream/master

6. Apăsați modificările la GitHub

În acest moment, filiala dvs. locală este sincronizată cu filiala principală a depozitului original. Dacă doriți să actualizați depozitul GitHub, trebuie să vă împingeți modificările.

$ git push origin master

NOTĂ: După ce ați sincronizat ramura principală furcată, puteți elimina telecomanda respectivă, dacă doriți. Dar va trebui să vă actualizați / sincronizați depozitul și în viitor, deci este cea mai bună practică să îl păstrați.

1611597487 516 Cum sa faci prima cerere de extragere pe GitHub
$ git remote rm [Remote Name]

8. Ștergeți ramura inutilă

Sucursalele sunt create pentru un scop special. Odată ce acest scop este atins, acele ramuri nu sunt necesare, astfel încât să le puteți șterge.

$ git branch -d [Branch Name]
1611597487 395 Cum sa faci prima cerere de extragere pe GitHub

Puteți șterge și versiunea acestuia pe GitHub.

git push origin --delete [Branch Name]
1611597487 462 Cum sa faci prima cerere de extragere pe GitHub

Concluzie

GitHub este un instrument puternic pentru a controla istoricul versiunilor. Toată lumea poate contribui la proiecte open source făcând cereri pull. Contribuțiile nu sunt întotdeauna cod – există și alte modalități de a contribui.

În cele din urmă, trebuie să vă spun că nu ar trebui să vă faceți griji dacă solicitările dvs. de pull sunt respinse. Mentenanții petrec mult timp îmbunătățindu-și proiectele și știu mult mai multe despre proiectele lor decât noi. Deci, nu vă faceți griji dacă solicitarea dvs. nu este combinată.

Rămâi puternic, rămâi pozitiv și nu renunța niciodată.
– Roy T. Bennett, Lumina din inimă

Acest articol a fost inițial postat pe Mediu.

Puteți contacta și conecta cu mine pe Stare de nervozitate.

Continuați să contribuiți la lumea open source!