Acest proiect își propune să simplifice și să îndrume modul în care începătorii își fac prima contribuție. Dacă doriți să faceți prima contribuție, urmați pașii de mai jos.
Dacă nu vă simțiți confortabil folosind linia de comandă, aici sunt tutoriale folosind alte unelte (GUI).
Dacă nu ai git instalat, instalează-l.
Efectuați bifurcația acestui depozit apăsând pe butonul Fork
din partea de sus a acestei pagini.
Aceasta va crea o copie a acestui depozit în contul dvs.
Acum clonați depozitul bifurcat pe computerul dvs. Mergeți în contul dvs. GitHub, deschideți depozitul bifurcat, apăsați pe butonul Code
și apoi pe pictograma de copiere în clipboard.
Deschideți un terminal și executați următoarea comandă Git:
git clone "URL-ul pe care l-ați copiat"
unde URL-ul pe care l-ați copiat
(fără ghilimele) este URL-ul către acest depozit (bifurcarea dvs. a acestui proiect). Consultați pașii anteriori pentru a obține URL-ul.
De exemplu:
git clone https://github.com/numele-tau/first-contributions.git
unde numele-tau
reprezintă numele dvs. de utilizator GitHub. Aici copiați conținutul depozitului first-contributions de pe GitHub pe computerul dvs.
Schimbați directorul depozitului de pe computerul dvs. (dacă nu sunteți deja acolo):
cd first-contributions
Acum creați o ramură folosind comanda git switch
:
git switch -c numele-noii-ramuri
De exemplu:
git switch -c adaug-alonzo-church
Acum deschideți fișierul Contributors.md
într-un editor de text, adăugați-vă numele în el. Nu-l adăugați la începutul sau la sfârșitul fișierului. Puneți-l oriunde între acestea. Apoi, salvați fișierul.
Dacă mergeți în directorul proiectului și executați comanda git status
, veți vedea că există modificări.
Adăugați aceste modificări în ramura pe care tocmai ați creat-o folosind comanda git add
:
git add Contributors.md
Acum comiteți acele modificări folosind comanda git commit
:
git commit -m "Adaug numele-tau la lista de Contribuitori"
înlocuind numele-tau
cu numele dvs.
Împinge schimbările tale cu comanda git push
:
git push -u origin numele-ramurii-tale
înlocuind numele-ramurii-tale
cu numele ramurii pe care ați creat-o anterior.
Dacă întâmpinați erori în timpul încărcării, apăsați aici:
remote: Suportul pentru autentificarea prin parolă a fost eliminat la 13 august 2021. Vă rugăm să utilizați un token de acces personal în schimb. remote: Vă rugăm să consultați https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ pentru mai multe informații. fatal: Autentificare eșuată pentru 'https://github.com//first-contributions.git/'
înlocuind numele-tau
cu numele dvs. de utilizator GitHub.
Mergeți la tutorialul GitHub pentru a genera și configura o cheie SSH pentru contul dvs.
Dacă mergeți în depozitul dvs. de pe GitHub, veți vedea un buton Compară și cereți trageri
. Faceți clic pe acest buton.
Acum trimiteți cererea de tragere.
În curând, voi integra toate modificările dvs. în ramura principală a acestui proiect. Veți primi o notificare prin e-mail odată ce modificările vor fi integrate.
Felicitări! Ați finalizat fluxul standard fork -> clone -> edit -> pull request pe care îl veți întâlni adesea ca contributor!
Sărbătoriți-vă contribuția și partajați-o cu prietenii și urmăritorii dvs., accesând aplicația web.
Puteți să vă alăturați echipei noastre Slack dacă aveți nevoie de ajutor sau aveți întrebări. Alăturați-vă echipei Slack.
Acum să vă începem cu contribuția la alte proiecte. Am compilat o listă de proiecte cu probleme ușoare cu care puteți începe. Verificați lista de proiecte din aplicația web.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |
Acest proiect este susținut de: