Alur Kerja Repository Relawan

Gambaran Umum Cara Kerja

Pengembangan aplikasi Relawan menggunakan metode fork flow, yang secara umum alur kerjanya adalah sebagai berikut:

1. Fork repository Relawan
2. Clone repository hasil fork
3. Tambahkan Upstream pada repository Relawan yang ada di lokal
4. Coding (tambah fitur, perbaiki bug, dll)
5. Commit untuk setiap perubahan atomik kemudian push di repo hasil fork
6. Pastikan tidak ada yang error, lakukan Pull Request dari repo hasil fork ke repo ngesec/relawan
7. Ketika ada Pull Request, akan ada tim yang memeriksa dan menyetujui

---

Apa Itu Fork?

Fork adalah membuat copy dari sebuah repository. Dengan membuat copy dari sebuah repository, maka kita bisa bereksperimen tanpa mempengaruhi repository utama.

Secara umum, fork digunakan ketika anda ingin mengusulkan perubahan (entah itu menambah fitur atau memperbaiki bug) pada repository Relawan. Caranya adalah sebagai berikut:

• Fork repository Relawan ke akun github anda
• Lakukan perubahan atau perbaikan
• Submit pull request ke pemilik proyek (atau proyek maintainer)

Apabila perubahan tersebut (sesuai yang ada pada pull request anda) sudah kami verifikasi dan sesuai dengan tujuan aplikasi Relawan, maka akan kami setujui perubahan tersebut (dengan cara pull dan merge ke repository Relawan).

---

Cara Fork Repository Relawan

1. Gunakan web browser (Chrome, Firefox, atau Edge) untuk mengunjungi repository Relawan
2. Pada bagian kanan atas, klik pada tombol bertuliskan Fork seperti pada gambar berikut:

maka proses fork sudah selesai. Untuk melakukan verifikasi, silahkan kunjungi akun github anda, repository Relawan akan tampak. Sebagai contoh, apabila username github anda adalah XXXX, maka repository Relawan dapat diakses secara langsung menggunakan url https://github.com/XXXX/relawan

Sebagai catatan, ketika baru melakukan Fork, maka repository Relawan baru tersedia pada akun github anda saja. File-file yang ada pada repository tersebut belum tersedia pada komputer/laptop.

repository hasil Fork ini (https://github.com/XXXX/relawan) juga sering disebut origin

---

Cara Clone Repository Relawan

pada terminal (Linux/Mac) atau git bash (Windows), lakukan perintah berikut:

git clone https://github.com/xxxxx/relawan.git

dimana xxxxx adalah username akun github anda.

---

Cara Menambahkan Upstream ke Repository Relawan

git remote add upstream https://github.com/NgeSEC/relawan.git

yang dimaksud dengan upstream adalah repository NgeSEC/Relawan

---

Langkah Teknis Berkontribusi

1. Pastikan kita sedang berada di branch master lokal

2. git pull —rebase upstream master

karena pada langkah 1 kita aktif di branch master, maka perintah ini akan mensinkronisasi upstream ke branch master yang ada di lokal.

3. buat branch baru di lokal dengan nama sesuai fitur dan checkout ke branch tersebut

git checkout -b nama-branch-baru

contoh: git checkout -b fitur-A

Pada langkah ini, isi branch fitur-A adalah sama dengan master di lokal

4. coding

5. commit setiap terjadi 1 perubahan atomik

yang dimaksud 1 perubahan atomik adalah 1 penambahan fitur atau 1 perbaikan bug, meski bisa saja ada perubahan ini terjadi pada banyak file

7. git push

8. buka akun github, lakukan pull request

Catatan: Seandainya saat coding (langkah 4), ternyata pada upstream terdapat update baru, maka kita bisa melakukan git pull --rebase upstream master, maka branch saat ini berisi upstream dan coding tambahan kita

---

Langkah Teknis Update Fork Relawan Ketika Terjadi Conflict

1. git pull --rebase upstream master
2. jika ada conflict:
   1. perbaiki file yang conflict
   2. git add nama_file_conflict
   3. git rebase --continue
   4. jika masih ada conflict:
      1. ulangi 2.i sampai 2.iii
      2. hingga tidak ada error conflict
3. pastikan kodingan jalan
4. git push origin branch-yang-di-PR-biasanya-master -f