README.id.md

Kontribusi yang Pertama

Proyek ini bertujuan untuk menyederhanakan dan memandu pemula untuk membuat kontribusi pertamanya. Jika kamu ingin membuat kontribusi pertama mu, ikuti langkah-langkah berikut.

Jika Anda tidak terbiasa dengan baris perintah, di sini ada tutorial menggunakan GUI.

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

Fork Repositori Ini

Fork repositori ini dengan cara klik tombol fork yang ada di bagian atas pada halaman ini. Dan repository ini akan disalin ke akun anda.

Klon Repositori

Sekarang klon repositori yang sudah Anda fork ke komputer anda. Buka akun GitHub Anda, buka repository yang sudah di fork, Klik tombol Code dan kemudian klik ikon salin ke papan klip.

Buka terminal dan jalankan perintah git berikut:

git clone "url yang telah Anda salin"

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

Contoh:

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

yang mana ini-adalah-anda adalah username GitHub Anda. Pada langkah ini, Anda menyalin konten dari repositori first-contributions di GitHub ke komputer Anda.

Membuat Cabang (Branch)

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

cd first-contributions

Sekarang buat cabang dengan menggunakan perintah git checkout:

git checkout -b <add-nama-cabang-baru>

Contohnya:

git checkout -b add-alonzo-church

Buat Perubahan yang Diperlukan Lalu Commit Perubahan Tersebut

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

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

Tambahkan perubahan tersebut ke cabang 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 <nama-Anda> dengan nama anda.

Dorong (Push) Perubahan ke GitHub

Dorong perubahan menggunakan perintah git push:

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

Ganti <add-nama-cabang-baru> dengan nama cabang yang sebelumnya Anda buat.

Jika Anda mendapatkan kesalahan saat mendorong, klik disini:

• Kesalahan otentikasi

  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 GitHub's tutorial untuk menghasilkan dan mengonfigurasi kunci SSH ke akun Anda.

Kirim Perubahan untuk Diperiksa

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

Sekarang kirimkan Pull Request (PR)

Segera saya (pengelola) akan menggabungkan semua perubahan Anda ke cabang utama 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 -> ubah -> Pull Request sebuah alur kerja yang akan sering Anda temui sebagai kontributor!

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

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

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.

Materi tambahan

Tutorial Menggunakan Alat Lain

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code