Nilalayon ng proyektong ito na gawing simple at gabayan ang paraan ng paggawa ng mga nagsisimula sa kanilang unang kontribusyon. Kung gusto mong gawin ang iyong unang kontribusyon, sundin ang mga hakbang sa ibaba.
Kung hindi ka komportable sa command line, narito ang mga tutorial gamit ang GUI tool.
Kung wala kang git sa iyong makina, i-install ito.
I-fork ang repository na ito sa pamamagitan ng pag-click sa fork button sa tuktok ng page na ito. Gagawa ito ng kopya ng repositoryong ito sa iyong account.
Ngayon i-clone ang forked repository sa iyong makina. Pumunta sa iyong GitHub account, buksan ang forked repository, i-click ang code button at pagkatapos ay i-click ang copy to clipboard icon.
Magbukas ng terminal at patakbuhin ang sumusunod na git command:
git clone "url na kinopya mo lang"
kung saan ang "url na kinopya mo lang" (nang walang mga panipi) ay ang url sa repositoryong ito (ang iyong tinidor ng proyektong ito). Tingnan ang mga nakaraang hakbang para makuha ang url.
Halimbawa:
git clone https://github.com/this-is-you/first-contributions.git
kung saan ang this-is-you ay ang iyong GitHub username. Dito mo kinokopya ang mga nilalaman ng repositoryo ng mga unang kontribusyon sa GitHub sa iyong computer.
Baguhin sa direktoryo ng repositoryo sa iyong computer (kung wala ka pa roon):
cd first-contributions
Ngayon lumikha ng isang sangay gamit ang utos na git switch:
git switch -c your-new-branch-name
Halimbawa:
git switch -c add-alonzo-church
Ngayon buksan ang Contributors.md file sa isang text editor, idagdag ang iyong pangalan dito. Huwag idagdag ito sa simula o dulo ng file. Ilagay ito kahit saan sa pagitan. Ngayon, i-save ang file.
Kung pupunta ka sa direktoryo ng proyekto at isagawa ang command na git status, makikita mong may mga pagbabago.
Idagdag ang mga pagbabagong iyon sa sangay na nilikha mo lamang gamit ang utos na git add:
git add Contributors.md
Ngayon gawin ang mga pagbabagong iyon gamit ang utos na git commit:
git commit -m "Add your-name to Contributors list"
Ngayon gawin ang mga pagbabagong iyon gamit ang utos na git commit:
Itulak ang iyong mga pagbabago gamit ang command na git push:
git push -u origin your-branch-name
pinapalitan ang your-branch-name ng pangalan ng branch na ginawa mo kanina.
Kung nakakakuha ka ng anumang mga error habang nagtutulak, mag-click dito:
-
remote: Inalis ang suporta para sa pagpapatotoo ng password noong Agosto 13, 2021. Mangyaring gumamit na lang ng personal na access token. remote: Pakitingnan ang https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ para sa karagdagang impormasyon. nakamamatay: Nabigo ang pagpapatotoo para sa 'https://github.com//first-contributions.git/'
Pumunta sa tutorial ng GitHub sa pagbuo at pag-configure ng SSH key sa iyong account.
Kung pupunta ka sa iyong repository sa GitHub, makakakita ka ng button na `Ihambing at hilahin ang kahilingan. I-click ang button na iyon.
Ngayon isumite ang kahilingan sa paghila.
Sa lalong madaling panahon, pagsasamahin ko ang lahat ng iyong mga pagbabago sa pangunahing sangay ng proyektong ito. Makakatanggap ka ng email ng notification kapag napagsama na ang mga pagbabago.
Congrats! Nakumpleto mo lang ang karaniwang fork -> clone -> edit -> pull request workflow na madalas mong makaharap bilang isang contributor!
Ipagdiwang ang iyong kontribusyon at ibahagi ito sa iyong mga kaibigan at tagasubaybay sa pamamagitan ng pagpunta sa web app.
Maaari kang sumali sa aming slack team kung kailangan mo ng anumang tulong o may anumang mga katanungan. Sumali sa slack team.
Ngayon simulan na natin ang pag-aambag sa iba pang mga proyekto. Nag-compile kami ng isang listahan ng mga proyekto na may mga madaling isyu na maaari mong simulan. Tingnan ang listahan ng mga proyekto sa web app.
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |