Sumbangan Pertama

Projek ini bertujuan untuk memberikan panduan dan memudahkan individu yang baru mula belajar membuat sumbangan pertama mereka. Jika anda ingin membuat sumbangan pertama anda, sila ikuti arahan yang disediakan di bawah.

Sekiranya anda tidak selesa dengan menggunakan antara muka baris perintah (CLI), anda boleh mengikuti panduan untuk menggunakan alat GUI di sini.

Jika git belum dipasang di mesin anda, sila memasangnya di sini.

Fork repositori ini

Fork repositori ini dengan menekankan butang 'Fork' yang terletak di bahagian atas halaman ini. Tindakan tersebut akan menghasilkan salinan repositori ini ke dalam akaun GitHub anda.

Klon repositori ini

Klon repositori yang anda telah fork ke mesin anda. Selepas itu, layari akaun GitHub anda, buka repositori yang baru dicabang, klik butang Clone, dan kemudian klik ikon Copy url to clipboard.

Buka terminal dan jalankan arahan git berikut:

git clone "URL anda baru disalin"

di mana "URL anda baru disalin" (tanpa tanda petikan) adalah URL ke repositori ini (fork anda bagi projek ini). Rujuk langkah-langkah sebelumnya untuk mendapatkan URL tersebut.

Contoh:

git clone https://github.com/<this-is-you>/first-contributions.git

di mana this-is-you adalah nama pengguna GitHub anda. Di sini, anda menyalinkan kandungan repositori GitHub 'first-contributions' ke komputer anda.

Membuat branch

Tukar ke direktori repositori pada komputer anda (jika lokasi CLI belum berada di sana):

cd first-contributions

Sila buat branch menggunakan arahan git switch:

git switch -c add-your-name

Contoh:

git switch -c add-emma-maembong

Buat perubahan yang diperlukan dan komit perubahan tersebut

Sekarang, buka fail Contributors.md dalam sebuah editor teks, dan tambahkan nama anda ke dalam fail itu. Jangan tambahkan pada awal atau akhir fail. Letakkan di mana-mana bahagian di antara kedua-duanya. Kemudian, simpan fail tersebut.

Jika anda pergi ke direktori projek dan laksanakan arahan git status, anda akan melihat perubahan tersebut.

Tambahkan perubahan itu ke branch yang baru anda cipta menggunakan arahan git add:

git add Contributors.md

Selepas itu, komit perubahan tersebut menggunakan arahan git commit:

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

menggantikan <your-name> dengan nama anda.

Push perubahan ke dalam GitHub

Tolak perubahan anda menggunakan arahan git push:

git push -u origin <add-your-name>

menggantikan <add-your-name> dengan nama branch yang kamu cipta sebelumnya.

Hantar perubahan anda untuk semakan

Jika anda pergi ke repositori anda di GitHub, anda akan melihat butang Compare & pull request. Klik butang tersebut.

Hantar 'pull request' tersebut.

Tidak lama lagi, saya akan menggabungkan semua perubahan anda ke dalam branch 'main' projek ini. Anda akan menerima e-mel pemberitahuan sebaik sahaja perubahan telah digabungkan.

Pergi ke mana selepas ini?

Tahniah! Anda baru saja selesai melaksanakan aliran kerja standard fork -> clone -> edit -> pull request yang sering anda akan temui sebagai seorang penyumbang!

Raikan sumbangan anda dan kongsi dengan rakan-rakan serta pengikut melalui aplikasi web.

Mari kita mulakan dengan menyumbang kepada projek lain. Kami telah menyediakan senarai projek dengan isu-isu mudah yang boleh anda mula sumbangkan. Sila rujuk senarai projek dalam aplikasi web.

Bahan tambahan

Tutorial Menggunakan Alat Lain

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA