Kontribusi pisanan

Proyek iki nduweni tujuan kanggo nyederhanakake lan nuntun cara para pamula nggawe kontribusi pisanan. Yen sampeyan pengin nggawe kontribusi pisanan, tindakake langkah ing ngisor iki.

Yen sampeyan ora kepenak karo baris perintah, iki tutorial nggunakake alat GUI.

Yen sampeyan ora duwe git ing mesin sampeyan, instal.

Garpu gudang iki

Garpu gudang iki kanthi ngeklik tombol garpu ing sisih ndhuwur kaca iki. Iki bakal nggawe salinan repositori iki ing akun sampeyan.

Kloning repositori

Saiki tiron repositori garpu menyang mesin sampeyan. Pindhah menyang akun GitHub sampeyan, bukak gudang bercabang, klik tombol kode, banjur ing tab SSH banjur klik copy url to clipboard icon.

Bukak terminal lan jalanake perintah git ing ngisor iki:

git clone "url you just copied"

ngendi "url sampeyan mung disalin" (tanpa tandha petik) punika url kanggo gudang iki (garpu proyek iki). Deleng langkah sadurunge kanggo njupuk url.

Contone:

git clone git@github.com:this-is-you/first-contributions.git

ngendi this-is-you jeneng panganggo GitHub sampeyan. Ing kene sampeyan lagi nyalin isi repositori kontribusi pisanan ing GitHub menyang komputer.

Nggawe cabang

Ganti menyang direktori repositori ing komputer (yen sampeyan durung ana):

cd first-contributions

Saiki gawe cabang nggunakake printah git switch:

git switch -c your-new-branch-name

Contone:

git switch -c your-new-branch-name

Yen sampeyan nemu kesalahan nggunakake git switch, klik kene:

Yen pesen kesalahan "Git: switch dudu perintah git. Waca git –help" katon, kemungkinan amarga sampeyan nggunakake versi git sing lawas.

Ing kasus iki, coba gunakake git checkout tinimbang:

git checkout -b jeneng-cabang-anyar sampeyan

Gawe owah-owahan sing perlu lan tindakake owah-owahan kasebut

Saiki bukak file Contributors.md ing editor teks, tambahake jeneng sampeyan. Aja ditambahake ing wiwitan utawa pungkasan file. Sijine ing ngendi wae ing antarane. Saiki, simpen file kasebut.

Yen sampeyan pindhah menyang direktori proyek lan nglakokake perintah git status, sampeyan bakal weruh ana owah-owahan.

Tambahake owah-owahan kasebut menyang cabang sing lagi wae digawe nggunakake perintah git add:

git add Contributors.md

Saiki gawe owah-owahan kasebut nggunakake perintah git commit:

git commit -m "Add your-name to Contributors list"

ngganti your-name karo jeneng sampeyan.

Push owah-owahan menyang GitHub

Push owahan sampeyan nggunakake printah git push:

git push -u origin your-branch-name

ngganti your-branch-name karo jeneng cabang sing digawe sadurunge.

Yen ana kesalahan nalika meksa, klik kene:

Kasalahan Authentication

remote: Dhukungan kanggo otentikasi tembung sandhi wis dibusak tanggal 13 Agustus 2021. Mangga gunakake token akses pribadhi.
remot: Mangga deleng https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ kanggo informasi luwih lengkap.
fatal: Otentikasi gagal kanggo 'https://github.com//first-contributions.git/'

Bukak Github's Tutorial kanggo nggawe lan ngatur kunci SSH menyang akun sampeyan.

Uga, sampeyan bisa uga pengin mbukak 'git remote -v' kanggo mriksa alamat remot.

Yen katon kaya iki:

asal https://github.com/your-username/your_repo.git (fetch)
origin https://github.com/your-username/your_repo.git (push)

ngganti nggunakake printah iki:

git remote set-url asal git@github.com:your-username/your_repo.git

Yen ora, sampeyan isih bakal dijaluk jeneng pangguna lan sandhi lan entuk kesalahan otentikasi.

Kirim owahan kanggo ditinjau

Yen sampeyan pindhah menyang repositori ing GitHub, sampeyan bakal weruh tombol Compare & pull request. Klik tombol kasebut.

Saiki kirim panjalukan tarik.

Sakcepete aku bakal nggabungake kabeh owah-owahan sampeyan menyang cabang utama proyek iki. Sampeyan bakal entuk email kabar yen owah-owahan wis digabung.

Saka ngendi arep lunga?

Sugeng! Sampeyan mung ngrampungake standar fork -> clone -> edit -> pull request workflow sing bakal kerep ditemoni minangka kontributor!

Rayakan kontribusi sampeyan lan enggo bareng karo kanca lan pandherekipun kanthi pindhah menyang web app.

Yen sampeyan pengin latihan liyane, priksa code contribution.

Saiki ayo miwiti kontribusi kanggo proyek liyane. Kita wis nyusun dhaptar proyek kanthi masalah sing gampang sampeyan bisa miwiti. Priksa the list of projects in the web app.