Cara Berkontribusi Open Source Github

Berkontribusi di Proyek git

---

Latar belakang

Mungkin sudah terlalu sering kita bekerja mandiri pada project pribadi. Disini, saya akan menunjukkan bagaimana caranya berkontribusi di project lain. Hal termudah untuk mencapai itu adalah dengan mencari proyek open source. Proyek perangkat lunak open source merupakan proyek yang memberikan kode program kepada penggunanya secara bebas, dan tak jarang pengembangannya dilakukan secara terbuka. siapapun boleh berkontribusi dalam menulis kode tersebut.

Menggunakan perangkat lunak open source tentunya sangat baik, karena selain tidak melakukan pembajakan, kita juga mendukung para pengembang dari perangkat lunak yang kita gunakan. Tetapi, akan lebih baik lagi jika kita juga ikut berkontribusi, mulai dari kontribusi pengunaan, pelaporan bug, sampai dengan kontribusi kode. Kontribusi pada proyek open source akan membantu kita untuk meningkatkan kemampuan pengembangan perangkat lunak.

---

Bagaimana

Berikut langkah-langkahnya secara singkat:

1. Fork it!
2. Buatlah branch fitur baru: git checkout -b my-new-feature
3. Commit perubahannya: git commit -am 'Add some features'
4. Push ke branch di remote: git push origin my-new-feature

5. Buat pull request

6. Cari proyek open source.
   Kali ini, saya sebagai pengembang Android akan menggunakan Material Tabs sebagai contoh.
7. Cari info tentang aturan kontribusi, atau hubungi developer yang terkait baik via email atau media sosial.
8. Jika memang tidak tertera aturan kontribusi dan sang developer tidak merespon, anda bisa langsung melakukan fork proyek yang akan anda kontribusikan.
9. Setelah selesai fork, maka repository akan masuk ke daftar repo milik anda.

---

Time to GO CODE ;)

NB: gunakan git --help untuk melihat perintah-perintah git lainnya.

1. Cloning project yang sudah anda fork ke akun anda

    git clone <alamat-repo>
   

   Contoh:

    git clone git@github.com:CreatorB/MaterialTabs.git
   

2. Untuk mempermudah pengembangan, hendaknya kita menambahkan repository pusat dengan lokal milik kita agar tidak terjadi konflik dengan kontributor lainnya.

    git remote add <nama-repo> <alamat-repo>
   

   Contoh:

    git remote add upstream git://github.com/neokree/MaterialTabs.git
   

3. Setelah remote repositori selesai, buatlah branch baru agar tidak merusak history branch utama, dan juga untuk memudahkan tracking code.

    git checkout -b <nama-cabang>
   

   Contoh:

    git checkout -b sample-project
   

4. Di cabang baru ini lah kita akan melakukan perubahan kode, yang nantinya bisa kita push ke repo pusat. Untuk berpindah branch bisa kita gunakan git checkout <nama-cabang>, dimana <nama-cabang> adalah nama yang anda gunakan pada langkah sebelumnya.

5. Setelah melakukan perubahan, kita bisa lakukan commit berisi deskripsi singkat tentang perubahan yang anda lakukan. Tetapi jika ada penambahan file, bisa menggunakan perintah git add <nama-file-baru>, atau gunakan git add . untuk menambahkan semua perubahan yang ada di direktori tersebut secara rekursif. Setelah itu baru bisa kita commit.

    git commit -m "<pesan singkat>"
   

   Contoh:

    git commit -m "fix sample project and added gradle compile"
   

6. Setelah selesai melakukan commit, kita akan melakukan persiapan untuk membuat pull request (biasa disingkat PR) ke repo pusat. Pertama kita pindah branch kembali ke master.

    git checkout master
   

7. Setelah itu, kita akan mengambil kode lagi dari pusat, untuk memastikan tidak terdapat konflik pada kontribusi kode kita. Konflik dapat terjadi jika dua atau lebih kontributor melakukan perubahan pada satu berkas, terutama jika perubahan dilakukan pada baris yang sama, terlepas dari apakah tujuan perubahan sama atau tidak.

    git fetch upstream
    git merge upstream/master
   

8. Dengan proses diatas, setidaknya kita telah bisa memastikan bahwa tidak ada konflik dengan repo pusat. Sekarang kita kembali ke branch lokal development kita sample-project.

    git checkout sample-project
   

9. Setelah itu, kita gabungkan cabang tersebut dengan cabang utama, sehingga kontribusi dapat dikirimkan kembali ke repositori pusat milik neokree, Material Tabs android library, dengan perintah git rebase <nama-branch>.

    git rebase master
   

10. Sebelum push ke repositori pusat milik neokree, kita akan push ke repository hasil fork di awal pembahasan tadi.

    git push origin sample-project
    

11. Setelah di push, kita akan melakukan pull request dan membandingkan perubahan yang telah anda lakukan terhadap repo pusat. Anda juga bisa menyisipkan pesan untuk memberitahukan developer pemilik repo pusat tentang apa yang anda lakukan. Setelah yakin terhadap perubahan yang telah anda lakukan, silahkan pilih create pull request dan menunggu tanggapan dari pemilik repo pusat. Lebih lengkapnya bisa anda lihat di tag screenshot.

---

Screenshot

notabene: Semua foto yang telah diunggah telah diubah sesuai dengan tampilan terbaru Github. Sumber untuk semua gambar diambil dari berbagai video Youtube dan bukan milik pribadi.

Ganti branch master ke branch yang anda buat (sample-project) dan pilih pull request / new pull request.

Setelah itu anda akan masuk pada konfirmasi pull request, disini anda bisa membandingkan code antar branch dan menyisipkan komentar.

Setelah melakukan pull request maka akan menuju tampilan request yang telah anda lakukan terhadap project tersebut.

---