Roshanjossey
5.2 KiB
Kontribusi Pertama
 |
GitHub Command Line Interface (CLI) |
|---|
Ini merupakan panduan untuk seseorang yang ingin melakukan semuanya lewat terminal. Hal ini dapat kita lakukan berkat adanya Github-CLI, sehingga kontribusi pertamamu menjadi lebih menyenangkan dan memotivasi kamu untuk terus berkontribusi.
Panduan ini sedikit lebih menantang karena kita tidak menggunakan GUI sama sekali, namun tentunya tetap seru dan bisa kamu ikuti dengan mudah.
Prasyarat pertama, kamu harus:
- Memastikan Git sudah terinstall (cara install git))
- Mempunyai akun Github
Selanjutnya, kita perlu menginstall github-cli di sistem kita dengan mengikuti langkah-langkah pada dokumentasi resmi
Setelah itu, kita harus login ke CLI dengan menjalankan perintah:
gh auth login
Ikuti instruksinya sampai kamu berhasil login.
Fork repositori ini
Caranya sangat mudah, dengan menjalankan perintah:
gh repo fork firstcontributions/first-contributions
Penting: Pilih opsi "yes" ketika muncul pertanyaan untuk mengkloning (clone) repositorinya.
Buat branch baru
Kita dapat melakukannya menggunakan git. Caranya dengan menjalankan perintah ini. Nama branch dapat kamu ganti sesuai dengan yang kamu mau, contohnya:
git switch -c add-john-doe
Lakukan perubahan yang diperlukan, kemudian Commit perubahan tersebut
Sekarang, kamu bisa buka file Contributors.md menggunakan teks editor pilihanmu, dan menambahkan namamu. Jangan lupa untuk save file nya.
Pada direktori proyek ini, jalankan perintah git status, kamu bisa melihat perubahan yang telah dilakukan.
Tambahkan perubahan tersebut ke branch yang sudah kamu buat menggunakan perintah git add:
git add Contributors.md
Kemudian commit perubahan tersebut menggunakan perintah git commit:
git commit -m "Add your-name to Contributors list
ganti your-name menggunakan namamu.
Push perubahan ke Github
Push perubahan yang kamu lakukan dengan perintah git push:
git push origin -u your-branch-name
ubah your-branch-name dengan nama branch yang kamu buat sebelumnya.
Kalo ada error saat melakukan push, klik di sini:
-
Authentication Error
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 tentang mengenerate dan menkonfigurasi SSH key untuk akunmu.
Submit perubahanmu untuk direview
Jalankan perintah berikut untuk membuat pull request supaya perubahanmu bisa direview:
gh pr create --repo firstcontributions/first-contributions
Setelah itu, submit pull requestnya.
Kamu bisa menjalankan perintah gh status untuk melihan pull request yang kamu ajukan.
Selanjutnya apa?
Selamat, kamu telah menyelesaikan langkah fork -> clone -> edit -> pull request yang pasti akan kamu lakukan saat menjadi kontributor.
Rayakan kontribusimu dan bagikan ke kawan-kawan mu dengan cara pergi ke web app.
Kamu juga bisa join ke slack team kami jika kamu butuh bantuan atau punya pertanyaan. Join slack team.
Sekarang, kamu bisa mulai berkontribusi ke proyek-proyek lain. Kami telah mengumpulkan beberapa proyek dengan issues yang mudah diselesaikan untuk kamu. Cek list nya di web app)