Kontribusi Pertama

Proyek ini bertujuan untuk menyederhanakan dan membimbing perjalanan seorang pemula berkontribusi di Github untuk pertama kali. Perhatikan langkah-langkah berikut untuk memulai:

Jika Anda tidak terbiasa dengan baris perintah(command line), di sini ada tutorial untuk menggunakan GUI(antarmuka bergrafis).

Apabila Anda belum menginstall git di komputer Anda, install segera.

Fork Repositori Ini

Fork repositori ini dengan cara klik tombol Fork yang ada di bagian atas kanan pada halaman ini. Hal Ini akan membuat sebuah salinan repositori di akun Anda.

Clone (Kloning) Repositori

Sekarang kloning repositori yang sudah Anda fork ke komputer Anda. Pergi ke akun GitHub Anda, buka repositori yang sudah Anda fork, klik tombol Code dan kemudian klik ikon salin ke papan klip.

Buka sebuah terminal dan jalankan perintah git berikut:

git clone "url yang telah Anda disalin"

bagian "url yang telah Anda disalin" (tanpa tanda petik) adalah url ke repositori ini (proyek yang telah Anda fork ini). Lihat langkah sebelumnya untuk mendapatkan url.

Contohnya:

git clone git@github.com:ini-adalah-anda/first-contributions.git

bagian ini-adalah-anda adalah nama pengguna GitHub Anda. Di sini Anda menyalin konten dari repositori first-contributions di GitHub ke komputer Anda.

Membuat Sebuah Branch (Cabang)

Pindah ke direktori repositori yang terdapat pada komputer Anda (jika Anda belum berada di sana):

cd first-contributions

Sekarang buatlah sebuah branch menggunakan perintah git checkout:

git checkout -b <tambahkan-nama-branch-baru>

Contohnya:

git checkout -b add-alonzo-church

Jika kamu mendapatkan beberapa kesalahan menggunakan git switch, klik disini:

Jika pesan error: "Git: switch is not a git command. See git –help" muncul, kemungkinan besar Anda menggunakan versi git yang lama.

Dalam kasus ini, coba gunakan git checkout sebagai gantinya:

git checkout -b your-new-branch-name

Buat Perubahan Yang Diperlukan Lalu Commit (Simpan) Perubahan Tersebut

Sekarang buka berkas Contributors.md menggunakan teks editor, tambahkan nama Anda ke dalamnya. Jangan menambahkan pada awal atau akhir dari berkas. Simpan dimana saja di antaranya. Sekarang simpan berkasnya.

Jika Anda pergi ke direktori proyek dan mengeksekusi perintah git status, Anda akan melihat ada sebuah perubahan.

Tambahkan perubahan tersebut ke branch yang baru saja Anda buat menggunakan perintah git add:

git add Contributors.md

Sekarang simpan perubahan tersebut menggunakan perintah git commit:

git commit -m "Add <nama-anda> to Contributors list"

Ubah bagian <nama-anda> dengan nama Anda.

Dorong (Push) Perubahan Ke GitHub

Push perubahan menggunakan perintah git push:

git push origin <tambahkan-nama-cabang-baru>

ganti bagian <tambahkan-nama-cabang-baru> dengan nama cabang yang sebelumnya Anda buat.

Jika Anda mendapatkan kesalahan saat melakukan push, klik disini:

Kesalahan Autentikasi
```
 <pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
```
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: Authentication failed for 'https://github.com//first-contributions.git/' Buka tutorial GitHub untuk menghasilkan dan mengkonfigurasi sebuah kunci SSH ke akun Anda.

Jika kelihatannya seperti ini:
```
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)
```
Buat perubahan dengan perintah:
```
git remote set-url origin git@github.com:your-username/your_repo.git
```
Jika tidak, Anda akan tetap dimintai nama pengguna dan kata sandi serta mendapatkan kesalahan autentikasi.

Kirim Perubahan Untuk Diperiksa

Jika Anda membuka repositori Anda di GitHub, Anda akan melihat sebuah tombol Compare & pull request. Tekan tombol tersebut.

Sekarang kirimkan Pull Request

Saya (pengelola) akan segera menggabungkan semua perubahan Anda ke cabang utama (main branch) dari proyek ini. Anda akan mendapatkan email pemberitahuan setelah perubahan digabungkan.

Ke Mana Lagi Setelah Dari Sini?

Selamat! Anda baru saja menyelesaikan standar fork -> clone -> edit -> pull request sebuah alur kerja yang akan sering Anda temui sebagai seorang kontributor!

Rayakan kontribusi Anda dan bagikan dengan teman-teman dan pengikut Anda dengan membuka web app.

Jika Anda ingin lebih banyak latihan, lihat kontribusi kode.

Sekarang mari kita mulai dengan berkontribusi di proyek lain. Kami sudah menyusun daftar proyek dengan isu yang mudah dikerjakan sehingga Anda dapat segera memulai. Cek di daftar proyek web app.