Materi Inti

A. Conventional Commits

Conventional Commits adalah standar penulisan pesan commit yang konsisten dan terstruktur. Format ini memudahkan pembacaan history dan otomatisasi (seperti changelog generation).

Format:

<tipe>[scope opsional]: <deskripsi>

[body opsional]

[footer opsional]

Tipe-tipe commit:

Contoh pesan commit lengkap:

feat(auth): tambah fitur reset password

Menambahkan halaman reset password yang mengirim
email verifikasi ke user. Menggunakan library
nodemailer untuk pengiriman email.

Closes #42

Tips: Gunakan bahasa yang konsisten di seluruh project. Boleh pakai bahasa Indonesia atau Inggris, tapi jangan dicampur.

B. Konvensi Penamaan Branch

Selain commit, nama branch juga perlu konsisten:

<tipe>/<deskripsi-singkat>

Warning: Hindari nama branch yang ambigu seperti fix, update, atau new-branch. Nama branch harus menjelaskan APA yang dikerjakan.

C. Branch Protection Rules

Branch protection rules mencegah perubahan langsung ke branch penting (seperti main atau develop) tanpa melalui proses review.

Cara mengaktifkan di GitHub:

1. Buka repository di GitHub
2. Settings lalu Branches
3. Klik “Add branch protection rule”
4. Branch name pattern: main
5. Centang aturan yang diinginkan

Aturan umum yang disarankan:

Info: Branch protection rules adalah salah satu cara terpenting untuk menjaga kualitas kode di tim. Dengan aturan ini, setiap perubahan di-review sebelum masuk ke production.

Demonstrasi Live

Setup Conventional Commits di Project

mkdir proyek-konvensi && cd proyek-konvensi && git init

# Commit awal
echo "# Proyek Konvensi" > README.md
git add . && git commit -m "init: setup project awal"

# Fitur baru
git switch -c feature/halaman-profil
echo "<h1>Profil</h1>" > profil.html
git add . && git commit -m "feat(profil): tambah halaman profil user"

echo "<form>Nama: <input></form>" >> profil.html
git add . && git commit -m "feat(profil): tambah form edit profil"

git switch main && git merge feature/halaman-profil
git branch -d feature/halaman-profil

# Perbaikan bug
git switch -c bugfix/typo-readme
echo "# Proyek Konvensi - Tim Hebat" > README.md
git add . && git commit -m "fix(docs): perbaiki typo di README"

git switch main && git merge bugfix/typo-readme
git branch -d bugfix/typo-readme

# Dokumentasi
git switch -c docs/panduan-instalasi
echo "## Instalasi\n1. Clone repo\n2. npm install" >> README.md
git add . && git commit -m "docs: tambah panduan instalasi di README"

git switch main && git merge docs/panduan-instalasi
git branch -d docs/panduan-instalasi

# Lihat history yang rapi dan konsisten
git log --oneline

Perhatikan bahwa setiap commit memiliki tipe yang jelas, sehingga mudah dipahami apa yang berubah.

Latihan Interaktif

Latihan Terminal: Praktik Conventional Commits

Buat project dengan minimal 10 commit menggunakan berbagai tipe Conventional Commits:

mkdir latihan-konvensi && cd latihan-konvensi && git init

# init
echo "# Toko Buku" > README.md
git add . && git commit -m "init: setup project toko buku"

# feat
git switch -c feature/katalog
echo "<div>Katalog Buku</div>" > katalog.html
git add . && git commit -m "feat(katalog): tambah halaman katalog"
git switch main && git merge feature/katalog && git branch -d feature/katalog

# feat lagi
git switch -c feature/keranjang
echo "<div>Keranjang</div>" > keranjang.html
git add . && git commit -m "feat(cart): tambah halaman keranjang belanja"
git switch main && git merge feature/keranjang && git branch -d feature/keranjang

# fix
git switch -c bugfix/typo
echo "<div>Katalog Buku Online</div>" > katalog.html
git add . && git commit -m "fix(katalog): perbaiki typo di judul katalog"
git switch main && git merge bugfix/typo && git branch -d bugfix/typo

# docs
echo "## Cara Pakai\nBuka index.html di browser" >> README.md
git add . && git commit -m "docs: tambah panduan penggunaan"

# style
echo "body { font-family: Arial; }" > style.css
git add . && git commit -m "style: tambah CSS dasar untuk font"

# refactor
echo "<main><div>Katalog Buku Online</div></main>" > katalog.html
git add . && git commit -m "refactor(katalog): bungkus konten dengan tag main"

# chore
echo "node_modules/\n.env\n.DS_Store" > .gitignore
git add . && git commit -m "chore: tambah file .gitignore"

# Lihat history
git log --oneline

Quiz Modul 2.2

Quiz ini menguji pemahaman tentang branching strategy, Conventional Commits, dan branch protection rules.

Passing grade: 70% (minimal 6 dari 8 benar)

Topik yang Diuji

Materi yang Perlu Dikuasai

Git Flow:

• Branch develop digunakan sebagai tempat integrasi fitur
• Git Flow tidak cocok untuk tim kecil yang deploy setiap hari
• Branch main hanya berisi kode production yang stabil

GitHub Flow:

• Paling cocok untuk tim yang melakukan continuous deployment
• Hanya ada main + feature branches + Pull Requests
• Main harus selalu dalam kondisi deployable

Trunk-Based Development:

• Menggantikan feature branch dengan feature flags
• Semua commit langsung ke main
• Membutuhkan CI/CD yang matang

Conventional Commits:

• Format: <tipe>[scope]: <deskripsi>
• feat untuk fitur baru, fix untuk bug, refactor untuk perubahan struktur
• refactor berarti mengubah struktur kode tanpa mengubah perilaku

Branch Protection:

• Mencegah push langsung ke branch penting tanpa PR dan review
• Penamaan branch yang baik menggunakan prefix: feature/, bugfix/, hotfix/

Tugas Mandiri

1. Terapkan Conventional Commits di semua commit selanjutnya pada project kamu
2. Buat 1 repo dengan branch protection rule di branch main (require pull request + require approval)
3. Praktikkan workflow lengkap: buat branch dengan nama konvensi, commit dengan format conventional, buat PR, merge