Dit is moeilik. Dit is altyd moeilik om die eerste keer iets te doen. Veral wanneer jy saamwerk, maak foute nie 'n gemaklike ding nie. Ons wou die manier waarop nuwe open source bydraers vir die eerste keer leer en bydra, vereenvoudig.
Lees artikels en kyk tutoriale kan help, maar wat is beter as om die goed in die praktyk te doen? Hierdie projek het ten doel om leiding te gee en die manier waarop beginners hul eerste bydrae maak, te vereenvoudig. As jy jou eerste bydrae wil maak, volg die onderstaande stappe.
As jy nie gemaklik is met die opdraglyn nie, is daar tutoriale wat GUI-instrumente gebruik.
As jy nie git op jou masjien het nie, installeer dit.
Vork hierdie repo deur op die vurk knoppie bo-aan hierdie bladsy te klik. Dit sal 'n kopie van hierdie repository in u rekening skep.
Klone nou die vurk repo aan jou masjien. Gaan na jou GitHub-rekening, maak die vurk repo oop, klik op die kloonknop en klik dan op die kopie na die knipbord- ikoon.
Open 'n terminaal en voer die volgende git opdrag uit:
git clone "url you just copied"
waar "url jy net gekopieer" het (sonder die aanhalingstekens) is die url na hierdie repository (jou vurk van hierdie projek). Sien die vorige stappe om die url te verkry.
Byvoorbeeld:
git clone https://github.com/this-is-you/first-contributions.git
waar this-is-youis
jou GitHub gebruikersnaam Hier kopieer jy die inhoud van die eerste bydrae repository in GitHub na jou rekenaar.
Verander na die repository gids op jou rekenaar (as jy nie reeds daar is nie):
cd first-contributions
Skep nou 'n tak met die git checkout
opdrag:
git checkout -b <add-your-new-branch-name>
Byvoorbeeld:
git checkout -b add-alonzo-church
(Die naam van die tak hoef nie die woord by te voeg nie, maar dit is 'n redelike ding om in te sluit omdat die doel van hierdie tak is om jou naam by 'n lys te voeg.)
Nou oop Contributors.md
lêer in 'n teksredigeerder, voeg jou naam daarby. Moet dit nie aan die begin of einde van die lêer byvoeg nie. Sit dit oral tussenin. Stoor nou die lêer.
As u na die projekgids gaan en die opdrag uitvoer git status
, sal u sien dat daar veranderinge is.
Voeg die veranderinge by die tak wat jy net geskep het deur die git add
opdrag te gebruik:
git add Contributors.md
Doen nou die veranderinge deur die git commit
opdrag te gebruik:
git commit -m "Add <your-name> to Contributors list"
vervang <your-name>
met jou naam.
Druk jou veranderinge deur die opdrag te gebruik git push
:
git push origin <add-your-branch-name>
vervang <add-your-branch-name>
met die naam van die tak wat jy vroeër geskep het.
As jy na jou repository op GitHub gaan, sal jy 'n Compare & pull
requestknoppie sien. Klik op daardie knoppie.
Dien nou die trekversoek in.
Binnekort sal ek al jou veranderinge in die meestertak van hierdie projek saamsmelt. U sal 'n kennisgewing-e-pos ontvang sodra die veranderinge saamgesmelt is.
Geluk! Jy het net die standaardvurk voltooi -> klone -> wysig -> PR- werkvloei wat jy dikwels as 'n bydraer sal ervaar!
Vier jou bydrae en deel dit met jou vriende en volgelinge deur na die webprogram te gaan .
U kan by ons span aansluit indien u enige hulp nodig het of enige vrae het. Sluit aan by 'n slapende span.
Kom ons begin met die bydrae tot ander projekte. Ons het 'n lys van projekte saamgestel met maklike probleme waarmee u kan begin. Kyk na die lys van projekte in die web app.
GitHub Desktop | Visuele Studio 2017 | GitKraken | Visuele Studio Kode | Atlassian Sourcetree | IntelliJ IDEA |