README.id.md

Kontribusi Pertama

Proyek ini memiliki tujuan yaitu untuk menyederhanakan dan membimbing pemula untuk melakukan kontribusi pertamanya di Github. Jika Anda ingin membuat kontribusi pertama mu, ikuti langkah-langkah berikut.

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. Dan repository ini akan disalin ke akun anda.

Clone Repositori

Sekarang klon repositori yang sudah Anda fork di akun Github anda 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 disalin"

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

Contoh:

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

bagian ini-adalah-anda adalah username GitHub Anda. Disini Anda menyalin konten dari repositori first-contributions di GitHub ke komputer Anda.

Membuat Cabang (Branch)

Pindah ke direktori repositori yang terdapat pada komputer Anda (jika Anda 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 Folder Contributors.md menggunakan editor teks(Text editor), tambahkan nama Anda ke dalamnya. Jangan menambahkan 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 bagian <nama-Anda> dengan nama anda.

Dorong (Push) Perubahan ke GitHub

Push perubahan menggunakan perintah git push:

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

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

Jika Anda mendapatkan kesalahan saat melakukan push, 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)

Saya (pengelola) akan segera 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(tools) Lain

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