Tidak terasa kita sudah memasuki bulan Oktober dan seperti biasa sudah ada banyak programmer yang share info terkait kontribusi ke open source, tanda event Hacktoberfest kembali dimulai. Sebagai pemula di dunia open source, hal yang pertama yang saya rasakan itu adalah ragu untuk memulai berkontribusi. Untuk itu saya mencoba untuk belajar kontribusi terlebih dahulu sebelum ikut dalam project open source. Kamu juga mengalami hal yang sama? Kalau begitu, yuk kita sama-sama belajar kontribusi di open source.
Dari postingan belajar cara berkontribusi ke open source ini, kita akan simulasikan alur untuk melakukan kontribusi ke open source, sehingga kita bisa sama-sama belajar, dimulai dari fork repositori sampai dengan melakukan pull request. Di sini juga kita sudah menyiapkan repositori khusus untuk belajar, jadi kita tidak harus cari repositori mana yang mau kita gunakan untuk belajar.
Dan untuk lebih jelasnya, di bawah ini adalah langkah-langkah untuk kontribusi di repositori belajar kontribusi.
Fork repositori ini dengan cara menekan tombol fork di sebelah kanan atas.
Tunggu sampai proses fork repositori selesai. Setelah selesai kita masuk ke halaman repositori hasil fork tadi dan biasanya ada keterangan forked from qadrLabs/belajar-kontribusi
di bawah nama repositori kita.
Selanjutnya, clone repo hasil fork yang ada di akun kamu ke komputer local. Tekan tombol Code, lalu tekan icon copy to clipboard .
Selanjutnya buka terminal, lalu run git command
di bawah ini:
git clone "url yang udah dicopy"
Contohnya:
git clone https://github.com/username-kamu/belajar-kontribusi.git
Di mana username-kamu
diisi sama username akun GitHub kamu.
Setelah repositori di-clone, selanjutnya kita masuk ke folder repositori dengan run command
:
cd belajar-kontribusi
Ketika kita ingin melakukan perubahan ada baiknya kita buat branch
baru. Nah sekarang kita buat branch baru menggunakan command git checkout
:
git checkout -b <add-nama-kamu>
Contohnya:
git checkout -b add-gun-gun
Nama branch-nya bebas. Nah umumnya disesuaikan sama tujuan branch dibuat ya. Setelah run command
di atas ada output seperti ini.
Switched to a new branch 'add-gun-gun'
Ini artinya kita sudah ada di branch yang baru saja kita buat.
Pada tahapan ini kita akan melakukan perubahan pada repositori, bisa dengan menambahkan kode, mengubah dokumentasi dan lain-lain.
Di tutorial belajar kontribusi kali ini, kita coba menambahkan file baru di dalam folder Contributors
.
Buat file baru di dalam folder Contributors
dengan format nama-kamu.md
contohnya (gun-gun-priatna.md
) menggunakan text editor favorit kamu. Di sini kita akan menggunakan Markdown. Tentang markdown bisa kamu baca-baca cheatsheet-nya di sini yaa..
Nah sekarang di file nama-kamu.md
, kita coba tuliskan nama dan deskripsi tentang kita.
Name: [nama-kamu](url-akun-github)
About: [Deskripsi tentang kamu]
Contohnya:
Name: [Gun Gun Priatna](https://github.com/gungunpriatna)
About: Saya seorang web developer
Kamu boleh menuliskan asal untuk nama dan deskripsinya ya, karena ini tujuannya untuk belajar, bukan untuk mengumpulkan data.
Sekarang run command git status
buat lihat modifikasi apa saja yang udah kamu lakukan.
Selanjutnya tambahkan dengan menggunakan command git add
:
git add Contributors/nama-kamu.md
Lalu commit modifikasi yang udah kamu buat menggunakan command: git commit
:
git commit -m "Add <nama-kamu> ke daftar kontributor"
Ubah <nama-kamu>
sama nama kamu ya.
Kita sudah menambahkan perubahan ke repositori belajar. Langkah selanjutnya adalah push branch repositori local ke github dengan command git push
:
git push origin <add-nama-kamu>
Ubah <add-nama-kamu>
dengan nama branch yang sebelumnya sudah dibuat.
Kalau kamu buka repositori kamu di GitHub, kamu bisa lihat tombol Compare & pull request
button. Tekan tombol tersebut.
Nah selanjutnya tekan tombol Create pull request.
Ya, selesai. Kalau kita sudah coba sampai tahap ini, kita tinggal menunggu hasil kontribusi kita direview dan diterima sama maintainer repositori.
Di tutorial ini, kita sudah belajar bagaimana cara berkontribusi ke project open source. Kita sudah coba simulasikan dari mulai fork repositori sampai dengan melakukan pull request. Setelah belajar di sini, kamu bisa coba ikut kontribusi langsung di GitHub ataupun GitLab. Biasanya ada banyak repositori yang bisa kamu coba untuk ikut berkontribusi.
Semoga bermanfaat dan semoga semakin semangat berkontribusi.
© 2024 qadrLabs . All rights reserved. 000515268