Este greu. Este întotdeauna greu atunci când faci ceva pentru prima dată. Mai ales atunci când colaborezi. A face greșeli nu este un lucru confortabil. Însa cele mai importante aspecte în open source sunt colaborarea și lucrul în echipă. Noi am vrut să simplificăm modul în care noii contribuabili învață și contribuie pentru prima dată la un proiect open source.
Citirea articolelor și vizionarea tutorialelor pot ajuta, însa ce este mai bine decât să faci lucrurile fără a strica ceva? Acest proiect își propune să ofere îndrumare și o simplificare a modului în care începătorii fac prima lor contribuție. Amintește-ți: cu cât ești mai relaxat, cu atât înveți mai bine. Dacă dorești să faci prima ta contribuție, urmează pur și simplu pașii de mai jos. Îți promit că va fi distractiv.
Citește în alte limbi.
Dacă nu ai git instalat, instalează-l .
Ramifică acest repository (depozit) făcând clic pe butonul fork locat pe partea de sus a paginii. Acesta va creea o copie a repozitoriului în contul tău.
Acum clonează acest repo pe computerul tău. Dă clic pe butonul clone apoi clic pe copiați în clipboard.
Deschide un terminal și executa următoarea comanda git:
git clone "adresa copiată"
unde "adresa copiată" (fără ghilimele) este adresa repozitoriului. Vezi pașii anteriori pentru a obține adresa.
De exemplu:
git clone https://github.com/acesta-ești-tu/prima-contribuție.git
Unde acesta-ești-tu este numele tău GitHub. Aici copiezi conținutul repozitorului GitHub "prima-contribuție" pe computerul tău.
Schimba directorul în repozitoriu pe computer (dacă nu ești deja acolo):
cd prima-contribuție
Acum crează o ramură cu ajutorul comenzii git checkout:
git checkout -b <adaug-numele-tău>
De exemplu:
git checkout -b adaug-alonzo-church
(nu este obligatoriu ca numele ramurii să conțină cuvantul adaug, însă poate fi un lucru util și rezonabil, deoarece scopul acestei ramuri este de a adăuga numele tău în lista!)
Acum deschide fișierul Contributors.md într-un editor de text (ca NotePad, Vim, nano, emacs, etc.), adaugă numele tău în el, apoi salvează fișierul. Dacă accesezi de proiect și execuți comanda git status, vei vedea schimbări. Adaugă acele schimbări la ramura creată de tine cu comanda git add:
git add Contributors.md
Acum comite acele schimbări cu comanda git commit:
git commit -m "Adaug <numele-tău> la lista de contribuitori"
înlocuind <numele-tău> cu numele tău.
Împinge modificările tale cu comanda git push:
git push origin <adaug-numele-tău>
înlocuind <adaug-numele-tău> cu numele ramurii create de tine anterior.
Dacă pleci la repozitoriul tău de pe GitHub, vei vedea butonul Compare & pull request(Compară & trage cererea). Apasă clic pe el.
Acum trimite solicitarea de tragere.
În scurt timp, eu voi adăuga toate modificările în ramura principală a acestui proiect. Vei primi un e-mail de notificare odată ce schimbările au fost fuzionate.
Felicitări! Tocmai ai terminat de făcut pașii standard fork->clone->edit->pull request pe care îi vei întâlni în mod frecvent ca și contributor!
Sărbătorește-ți contribuția și împărtășește-o cu prietenii și cu fanii tai accesând aplicația web.
Daca dorești, poți să te alături echipei noastre în cazul în care ai nevoie de ajutor sau ai întrebări. Alătură-te echipei Slack.
Acum, să începem să contribuim la alte proiecte. Am compilat o listă de proiecte cu probleme ușoare pe care le poți începe. Verifică lista de proiecte in aplicația web.
 |
 |
 |
|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken |