Este greu. Este întotdeauna greu când faci ceva pentru prima dată. Mai ales când colaborezi. A face greșeli nu este un lucru confortabil. Dar cel mai important în open source este colaborarea și lucrul în echipă. Noi am vrut să simplificăm modul în care noii contribuabili în open source învață și contribuie pentru prima dată.
Citirea articolelor și vizionarea tutorialelor poate ajuta, dar ce este mai bine decât să faci lucrurile fără a strica ceva? Acest proiect își propune să ofere îndrumare și simplificarea modului în care începătorii își fac prima contribuție. Amintește-ți: cu cât ești mai relaxat, cu atât mai bine înveți. Dacă dorești să faci prima ta contribuție, simplu urmați pașii de mai jos. Vă promit că va fi distractiv.
Citește în alte limbi.
Dacă nu ai git instalat, instalează-l .
Ramifică acest repo(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. Fă clic pe butonul clone apoi clic pe copiați în clipboard.
Deschideți un terminal și executați următoarea comanda git:
git clone "adresa copiată"
Unde "adresa copiată" (Fără de 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 tu copiezi conținutul repozitorului GitHub "prima-contribuție" pe computerul tău.
Schimbați directorul în repozitoriu pe computer (dacă nu sunteți deja acolo):
cd prima-contribuție
Acum creați o ramură cu ajutorul comenzii git checkout
:
git checkout -b <adaug-numele-tău>
De exemplu:
git checkout -b adaug-alonzo-church
(Numele ramurii nu e obligatoriu să fie adaug, dar e un lucru rezonabil pentru a include deoarece scopul acestei ramure 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 directorul 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"
Schimbând <numele-tău>
cu numele tău.
Împinge schimbările tale cu comanda git push
:
git push origin <adaug-numele-tău>
Schimbând <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). Fă clic pe el.
Acum trimiteți solicitarea de tragere.
Curând eu voi îmbina toate schimbările în ramura principală a acestui proiect. Veți primi un e-mail de notificare odată ce schimbările au fost fuzionate.
Sărbătoriți-vă contribuția și împărtășiți-o cu prietenii și adepții dvs. accesând aplicația web.
Ați putea să vă alăturați echipei noastre în cazul în care aveți nevoie de ajutor sau aveți întrebări. Alătură-te echipei Slack.
Acum, să începem să contribuiți la alte proiecte. Am compilat o listă de proiecte cu probleme ușoare pe care le puteți începe. Verifică lista de proiecte in aplicația web.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |