O cerere de extragere (PR) este o caracteristică GitHub care vă permite să propuneți modificări la un depozit la care nu aveți acces de scriere. Administratorii depozitului pot revizui aceste modificări și, dacă aleg, le pot îmbina în depozitul original.
Deschiderea solicitărilor de extragere pe GitHub este crucială pentru a contribui la proiecte open-source și a colabora cu alți dezvoltatori. Aflați cum să creați și să deschideți o solicitare de extragere pe GitHub în doar câțiva pași simpli.
Pasul 1: Bifurcarea depozitului
Activarea unui depozit platforma GitHub creează o copie – altfel cunoscută sub numele de „furcătură” – a acelui depozit, sub contul dvs. Furcarea unui depozit vă permite să faceți modificări codului fără a afecta depozitul original.
Pentru a bifurca un depozit, navigați la pagina principală a acestuia și faceți clic pe furculiţă butonul din colțul din dreapta sus:
Completați numele depozitului (furcătură) și o descriere opțională și faceți clic Creați furculița:
Acum ați creat o copie a depozitului original. Acest nou depozit are o conexiune cu originalul, astfel încât orice modificări pe care le faceți codului pot fi ușor comparate și îmbinate înapoi în el.
Pasul 2: Efectuarea modificărilor codului
După ce ați transferat depozitul, poate fi necesar să-l clonați pe mașina dvs. locală, în funcție de cantitatea și natura modificărilor pe care doriți să le propuneți. Dacă faceți modificări foarte simple pe care nu trebuie să le testați, puteți face acest lucru online folosind editorul web GitHub.
Pentru a clona un depozit pe mașina dvs. locală folosind Git, rulați această comandă de terminal:
git clonare
A inlocui cu adresa URL a depozitului dvs. - o puteți găsi pe GitHub. Această comandă va clona depozitul pe mașina dvs. locală, unde puteți experimenta liber și face modificări codului.
Ar trebui să vă păstrați modificările mici și concentrate, deoarece solicitările de extragere mari pot fi dificil de revizuit și de îmbinat. Încercați să păstrați modificările specifice unei singure probleme sau caracteristici, pentru a le permite întreținătorilor să le examineze și să le accepte mai ușor.
După ce ați făcut modificările dorite la nivel local, comite-le și împinge-le în furcul tău GitHub folosind Git.
Pasul 3: Deschiderea unei cereri de tragere
După ce ați efectuat modificările în GitHub, ar trebui să vedeți un prompt care vă avertizează că ramura dvs. este un număr de „comite” înaintea depozitului din care ați transferat-o, de exemplu:
Apasă pe A contribui scapă jos. Făcând clic pe acest buton, vă va solicita să deschideți o cerere de extragere. Apoi, faceți clic pe Deschideți cererea de tragere buton:
Unele depozite au reguli specifice de contribuție, pe care le puteți găsi de obicei într-un fișier CONTRIBUTING.md, pe care trebuie să le urmați. Asigurați-vă că citiți și urmați aceste instrucțiuni înainte de a trimite o cerere de extragere.
Apoi, completați câmpurile obligatorii și faceți clic pe Creați cerere de tragere buton:
Mesajul dvs. de angajare ar trebui să fie clar și concis, descriind modificările pe care le-ați făcut și raționamentul din spatele lor. Acest lucru îi va ajuta pe menținătorii să înțeleagă modificările dvs. și să le fie mai ușor să revizuiască codul.
Odată ce ați creat pullul, va trebui să așteptați ca întreținătorii proiectului să îl revizuiască și să îl îmbine sau să îl închidă. Menținătorii pot avea sugestii sau feedback cu privire la cererea dvs. de extragere. Fiți deschis la schimbări și dispuși să faceți revizuiri dacă vă solicită acest lucru.
Importanța solicitărilor de tragere
Solicitările pull facilitează colaborarea între dezvoltatori, permițându-le să propună modificări, să ofere feedback și să revizuiască codul. Acest lucru ajută la stimularea unui sentiment de comunitate și de colaborare în cadrul unui proiect, ceea ce duce la mai multe contribuții și la o dezvoltare mai rapidă.
În plus, solicitările de extragere organizează istoricul proiectului și versiunea, permițând întreținătorilor să țină evidența diferitelor versiuni ale codului și a modificărilor aduse fiecărei versiuni.
