FirstContribution

Kontribusi pertama

Itu sulit. Selalu sulit pertama kali Anda melakukan sesuatu. Terutama ketika Anda berkolaborasi, membuat kesalahan bukanlah hal yang nyaman. Kami ingin menyederhanakan cara kontributor open-source baru belajar & berkontribusi untuk pertama kalinya.

Membaca artikel & menonton tutorial dapat membantu, tetapi apa yang lebih baik daripada benar -benar melakukan hal -hal di lingkungan latihan? Proyek ini bertujuan memberikan panduan & menyederhanakan cara pemula memberikan kontribusi pertama mereka. Jika Anda ingin memberikan kontribusi pertama, ikuti langkah -langkah di bawah ini.

Jika Anda tidak memiliki git di mesin Anda, instal.

Garakan repositori ini

Fork Repositori ini dengan mengklik tombol Fork di bagian atas halaman ini. Ini akan membuat salinan repositori ini di akun Anda.

Klon Repositori

Sekarang klon repositori bercabang ke mesin Anda. Buka akun GitHub Anda, buka repositori bercabang, klik tombol klon dan kemudian klik ikon salin ke clipboard .

Buka terminal dan jalankan perintah git berikut:

 git clone "url you just copied"

Di mana "URL yang baru saja Anda salin" (tanpa tanda kutip) adalah URL untuk repositori ini (garpu Anda dari proyek ini). Lihat langkah -langkah sebelumnya untuk mendapatkan URL.

Misalnya:

 git clone https://github.com/this-is-you/FirstContribution.git

Di mana this-is-you adalah nama pengguna GitHub Anda. Di sini Anda menyalin isi repositori Kontribusi Pertama di GitHub ke komputer Anda.

Buat cabang

Ubah ke direktori repositori di komputer Anda (jika Anda belum ada di sana):

 cd FirstContribution

Sekarang buat cabang menggunakan perintah git checkout :

 git checkout -b <add-your-new-branch-name>

Misalnya:

 git checkout -b add-alonzo-church

(Nama cabang tidak perlu memiliki kata yang ditambahkan di dalamnya, tetapi itu adalah hal yang masuk akal untuk dimasukkan karena tujuan cabang ini adalah untuk menambahkan nama Anda ke daftar.)

Membuat perubahan yang diperlukan dan melakukan perubahan itu

Sekarang buka file Contributors.md di editor teks, tambahkan nama Anda ke dalamnya. Sekarang, simpan file.

Jika Anda pergi ke direktori proyek dan menjalankan git status , Anda akan melihat ada perubahan.

Tambahkan perubahan itu ke cabang yang baru saja Anda buat menggunakan perintah git add :

 git add Contributors.md

Sekarang melakukan perubahan itu menggunakan perintah git commit :

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

Mengganti <your-name> dengan nama Anda.

Dorong Perubahan ke GitHub

Dorong perubahan Anda menggunakan git push :

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

Mengganti <add-your-branch-name> dengan nama cabang yang Anda buat sebelumnya.

Kirimkan perubahan Anda untuk ditinjau

Jika Anda pergi ke repositori Anda di GitHub, Anda akan melihat tombol Compare & pull request . Klik tombol itu.

Sekarang kirimkan permintaan tarik.

Segera saya akan menggabungkan semua perubahan Anda ke dalam cabang utama proyek ini. Anda akan mendapatkan email pemberitahuan setelah perubahan telah digabungkan.

Kemana harus pergi dari sini?

Selamat! Anda baru saja menyelesaikan garpu standar -> Clone -> Edit -> alur kerja PR yang akan sering Anda temui sebagai kontributor!

Anda dapat bergabung dengan tim Slack kami jika Anda membutuhkan bantuan atau memiliki pertanyaan bergabung dengan tim Slack.