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.

  1. Fork repositori belajar kontribusi
  2. Clone repositori hasil fork
  3. Buat branch baru
  4. Modifikasi dan commit
  5. Push ke GitHub
  6. Pull Request

1. Fork Repositori

Fork repositori ini dengan cara menekan tombol fork di sebelah kanan atas.

fork repositori

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.

2. Clone repositori hasil fork

Selanjutnya, clone repo hasil fork yang ada di akun kamu ke komputer local. Tekan tombol Code, lalu tekan icon copy to clipboard . clone repositori

copy link untuk clone repository

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.

3. Buat branch baru

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.

4. Modifikasi dan Commit

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.

5. Push ke GitHub

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.

6. Pull Request

Kalau kamu buka repositori kamu di GitHub, kamu bisa lihat tombol Compare & pull request button. Tekan tombol tersebut.

Coba untuk pull request

Nah selanjutnya tekan tombol Create pull request.

Create pull request

Ya, selesai. Kalau kita sudah coba sampai tahap ini, kita tinggal menunggu hasil kontribusi kita direview dan diterima sama maintainer repositori.

Kesimpulan

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.

Gun Gun Priatna
Software Engineer, Content Writer and Founder qadrlabs.com
Komentar

blog comments powered by Disqus