From fec58f14b5df2cb98e07f8edebf9587c2da05706 Mon Sep 17 00:00:00 2001 From: Fanrouver Date: Fri, 10 Jul 2026 14:06:15 +0700 Subject: [PATCH] docs: add Git workflow and branching guide for team reference --- docs/GIT_WORKFLOW.md | 84 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 docs/GIT_WORKFLOW.md diff --git a/docs/GIT_WORKFLOW.md b/docs/GIT_WORKFLOW.md new file mode 100644 index 0000000..36e9b93 --- /dev/null +++ b/docs/GIT_WORKFLOW.md @@ -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.