docs: add Git workflow and branching guide for team reference

2026-07-10 14:06:15 +07:00
parent bbcaf9826c
commit fec58f14b5
1 changed files with 84 additions and 0 deletions
@@ -0,0 +1,84 @@
+# 🌿 Git Workflow & Branching Guide
+
+Dokumen ini berisi panduan *step-by-step* untuk mengelola Git *branch* di project **web-antrean**. Branch utama (main) untuk project ini adalah **`Antrean-Code`**.
+
+---
+
+## 1. Persiapan Sebelum Mengubah Kode (Membuat Branch Baru)
+Sangat disarankan untuk tidak mengubah kode secara langsung di `Antrean-Code`. Buatlah branch baru untuk setiap fitur atau perbaikan *bug*.
+
+**Langkah-langkah:**
+1. Pastikan Anda berada di branch utama dan kodenya terbaru:
+   ```bash
+   git checkout Antrean-Code
+   git pull origin Antrean-Code
+   ```
+2. Buat dan pindah ke branch baru (misalnya `fitur-baru`):
+   ```bash
+   git checkout -b nama-fitur-anda
+   ```
+   *(Contoh: `git checkout -b tes-refaktoring`)*
+
+---
+
+## 2. Menyimpan Perubahan (Commit)
+Setelah Anda selesai menulis kode, ikuti langkah ini untuk menyimpannya.
+
+**Langkah-langkah:**
+1. Cek file apa saja yang berubah:
+   ```bash
+   git status
+   ```
+2. Tambahkan file yang ingin disimpan:
+   ```bash
+   git add .
+   ```
+   *(Tanda `.` artinya menambahkan semua file. Anda juga bisa menyebut nama filenya satu-satu)*
+3. Lakukan commit dengan pesan yang jelas (mengikuti aturan Conventional Commits di SKILL.md):
+   ```bash
+   git commit -m "feat: menambah fitur X"
+   ```
+
+---
+
+## 3. Menggabungkan Kode ke Branch Utama (Merge ke Antrean-Code)
+Jika fitur di branch Anda sudah selesai dan teruji, saatnya menggabungkannya (*merge*) kembali ke `Antrean-Code`. Ini adalah tahapan yang baru saja kita lakukan.
+
+**Langkah-langkah:**
+1. Pastikan tidak ada perubahan yang belum di-commit di branch Anda (harus clean).
+   ```bash
+   git status
+   ```
+2. Pindah ke branch utama (`Antrean-Code`):
+   ```bash
+   git checkout Antrean-Code
+   ```
+3. Gabungkan (*merge*) branch fitur Anda (misal `tes-refaktoring`) ke `Antrean-Code`:
+   ```bash
+   git merge tes-refaktoring
+   ```
+4. Jika tidak ada konflik, Git akan otomatis menyatukan kodenya. (Jika ada konflik, Anda harus memperbaikinya secara manual di code editor, lalu `git add .` dan `git commit`).
+
+---
+
+## 4. Mengunggah Kode ke Server (Push ke Remote)
+Setelah merge selesai di komputer lokal, Anda harus mengunggah perubahannya ke server GitLab/GitHub.
+
+**Langkah-langkah:**
+1. Pastikan Anda berada di branch `Antrean-Code`.
+2. Push ke remote origin:
+   ```bash
+   git push origin Antrean-Code
+   ```
+
+---
+
+## 5. Membersihkan Branch (Opsional)
+Jika branch fitur sudah berhasil di-merge dan di-push, Anda bisa menghapusnya agar daftar branch lokal tetap rapi.
+```bash
+git branch -d tes-refaktoring
+```
+
+---
+> **Catatan Penting:**
+> Jangan lupa untuk selalu mengacu pada `docs/DEVLOG.md` saat Anda berhasil menggabungkan fitur besar untuk mencatat apa saja yang baru dirilis.