Update documentation: gh-pages now contains build files only

- Updated README.md to clarify gh-pages branch structure
- Updated DEPLOY_MANUAL.md with detailed workflow explanation
- Updated DEPLOYMENT_WORKFLOW.md with clean deploy process
- Updated QUICK_REFERENCE.md with simplified commands
- All documentation now emphasizes that gh-pages contains only build output

Author: sandikodev

README.md

@@ -10,7 +10,7 @@ Repository ini berisi source code untuk website resmi KonXC. Website ini dibangu
 - **Astro** - Static site generator
 - **Tailwind CSS** - CSS framework
 - **pnpm** - Package manager
-- **GitHub Pages** - Hosting platform
+- **GitHub Pages** - Hosting platform (manual deployment)
 
 ## 🚀 Quick Start
 
@@ -50,37 +50,20 @@ Website akan tersedia di `http://localhost:4321`
 
 Karena masalah billing dengan GitHub Actions, deployment dilakukan secara manual menggunakan script yang telah disediakan.
 
+**Branch gh-pages hanya berisi hasil build**, tidak ada source code!
+
 ### Cara Deploy Manual
 
-#### Menggunakan Script (Recommended)
 ```bash
-# Linux/macOS
-./scripts/deploy-manual.sh
-
-# Windows (Git Bash/WSL)
-./scripts/deploy-manual.bat
+# Linux/macOS/Windows (Git Bash)
+bash ./scripts/deploy-manual.sh
 ```
 
-#### Manual Step-by-Step
-```bash
-# 1. Pastikan di branch main dan pull latest changes
-git checkout main
-git pull origin main
-
-# 2. Install dependencies dan build
-pnpm install
-pnpm run build
-
-# 3. Deploy ke branch gh-pages
-git checkout gh-pages
-cp -r dist/* .
-git add .
-git commit -m "Deploy: $(date '+%Y-%m-%d %H:%M:%S') - Manual deployment"
-git push origin gh-pages
-
-# 4. Kembali ke main
-git checkout main
-```
+Script akan otomatis:
+1. Pull latest changes dari main
+2. Build project
+3. **Deploy hanya hasil build** ke branch gh-pages
+4. Push ke GitHub Pages
 
 ### 📚 Dokumentasi Lengkap
 Lihat [docs/DEPLOY_MANUAL.md](./docs/DEPLOY_MANUAL.md) untuk dokumentasi deploy yang lebih detail.
@@ -95,18 +78,24 @@ Lihat [docs/DEPLOY_MANUAL.md](./docs/DEPLOY_MANUAL.md) untuk dokumentasi deploy
 │   └── components/        # Reusable components
 ├── scripts/               # Deployment scripts
 ├── docs/                  # Documentation
+├── dist/                  # Build output (git ignored)
 ├── astro.config.mjs       # Astro configuration
 ├── tailwind.config.js     # Tailwind configuration
 └── package.json           # Dependencies
 ```
 
+### Branch Structure
+- **main**: Development branch (source code)
+- **gh-pages**: Deployment branch (build files only)
+
 ## 🔧 Maintenance Guide
 
 ### Untuk Tim Development
 
 1. **Development Workflow**:
    - Buat perubahan di branch `main`
    - Test lokal dengan `pnpm dev`
+   - Test build dengan `pnpm build`
    - Deploy menggunakan script manual
 
 2. **Update Content**:
@@ -122,13 +111,14 @@ Lihat [docs/DEPLOY_MANUAL.md](./docs/DEPLOY_MANUAL.md) untuk dokumentasi deploy
    - [ ] Pastikan perubahan sudah di-commit di branch main
    - [ ] Test build lokal dengan `pnpm build`
    - [ ] Jalankan script deploy manual
-   - [ ] Verifikasi website di https://www.konxc.space
+   - [ ] Verifikasi website di https://www.konxc.space (tunggu 2-5 menit)
 
 ### Troubleshooting
 
 - **Build Error**: Periksa syntax Astro dan dependencies
 - **Deploy Error**: Pastikan pnpm terinstall dan script executable
-- **Website tidak update**: Tunggu beberapa menit, GitHub Pages butuh waktu
+- **Website tidak update**: Tunggu 2-5 menit, GitHub Pages butuh waktu
+- **Lihat dokumentasi lengkap**: `docs/TROUBLESHOOTING.md`
 
 ## 📞 Support
 
@@ -139,4 +129,4 @@ Untuk pertanyaan atau masalah:
 
 ## 📄 License
 
-Repository ini adalah milik KonXC. Semua hak cipta dilindungi.
+Repository ini adalah milik KonXC. Semua hak cipta dilindungi.

docs/DEPLOYMENT_WORKFLOW.md

@@ -27,14 +27,17 @@
 - Commit dan push perubahan ke repository
 
 ### 2. Deployment Phase
-- Jalankan script deploy manual: `./scripts/deploy-manual.sh`
+- Jalankan script deploy manual: `bash ./scripts/deploy-manual.sh`
 - Script akan:
   - Pull latest changes dari main
   - Install dependencies dengan pnpm
-  - Build project dengan Astro
+  - Build project dengan Astro ke folder `dist/`
+  - Copy built files ke temporary directory
   - Switch ke branch gh-pages
-  - Copy built files ke root
+  - **Hapus semua file lama** di gh-pages
+  - **Copy hanya hasil build** dari temporary directory
   - Commit dan push ke gh-pages branch
+  - Kembali ke branch main
 
 ### 3. GitHub Pages Deployment
 - GitHub Pages otomatis detect perubahan di branch gh-pages
@@ -52,9 +55,11 @@
 ## ⚠️ Important Notes
 
 - **Branch Separation**: Main untuk development, gh-pages untuk deployment
+- **Build Only**: Branch gh-pages **hanya berisi hasil build**, tidak ada source code
 - **Manual Process**: Deployment harus dilakukan secara manual
 - **Script Dependency**: Pastikan pnpm dan Node.js terinstall
-- **Timing**: GitHub Pages butuh waktu untuk update
+- **Timing**: GitHub Pages butuh waktu 2-5 menit untuk update
+- **Clean Deploy**: Setiap deploy membersihkan gh-pages terlebih dahulu
 
 ## 🛠️ Maintenance
 

docs/DEPLOY_MANUAL.md

@@ -4,6 +4,8 @@
 
 Dokumentasi ini menjelaskan cara melakukan deploy manual untuk website www.konxc.space menggunakan script yang telah disediakan. Script ini dibuat sebagai alternatif dari GitHub Actions karena masalah billing.
 
+**Penting**: Branch `gh-pages` **hanya berisi hasil build** dari folder `dist/`, tidak ada file source code.
+
 ## 🛠️ Prerequisites
 
 Sebelum melakukan deploy, pastikan Anda telah menginstall:
@@ -22,7 +24,7 @@ Sebelum melakukan deploy, pastikan Anda telah menginstall:
 #### Untuk Linux/macOS:
 ```bash
 # Jalankan script deploy
-./scripts/deploy-manual.sh
+bash ./scripts/deploy-manual.sh
 ```
 
 #### Untuk Windows (Git Bash/WSL):
@@ -31,6 +33,22 @@ Sebelum melakukan deploy, pastikan Anda telah menginstall:
 ./scripts/deploy-manual.bat
 ```
 
+### Apa yang Dilakukan Script?
+
+Script akan secara otomatis:
+1. ✅ Checkout ke branch `main` dan pull latest changes
+2. ✅ Install dependencies dengan `pnpm install`
+3. ✅ Build project dengan `pnpm run build`
+4. ✅ Copy hasil build ke temporary directory
+5. ✅ Checkout ke branch `gh-pages` (atau buat jika belum ada)
+6. ✅ **Hapus semua file lama** di gh-pages
+7. ✅ **Copy hanya hasil build** dari temporary directory
+8. ✅ Tambahkan file `.nojekyll` untuk GitHub Pages
+9. ✅ Commit dan push ke branch `gh-pages`
+10. ✅ Kembali ke branch `main`
+
+**Hasil**: Branch `gh-pages` hanya berisi file-file hasil build (HTML, CSS, JS, assets) tanpa source code.
+
 ### Metode 2: Manual Step-by-Step
 
 Jika script tidak berfungsi, Anda bisa melakukan deploy secara manual:
@@ -40,28 +58,37 @@ Jika script tidak berfungsi, Anda bisa melakukan deploy secara manual:
 git checkout main
 git pull origin main
 
-# 2. Install dependencies
+# 2. Install dependencies dan build
 pnpm install
-
-# 3. Build project
 pnpm run build
 
-# 4. Switch ke branch gh-pages (atau buat jika belum ada)
+# 3. Copy dist ke temporary location
+cp -r dist /tmp/konxc-deploy
+
+# 4. Switch ke branch gh-pages
 git checkout gh-pages
-# atau jika branch belum ada:
-# git checkout --orphan gh-pages
+git config pull.rebase false
+git pull origin gh-pages
 
-# 5. Copy semua file dari dist ke root
-cp -r dist/* .
-cp dist/.* . 2>/dev/null || true
+# 5. Hapus semua file kecuali .git
+find . -maxdepth 1 ! -name '.git' ! -name '.' ! -name '..' -exec rm -rf {} +
 
-# 6. Commit dan push
-git add .
-git commit -m "Deploy: $(date '+%Y-%m-%d %H:%M:%S') - Manual deployment"
-git push origin gh-pages
+# 6. Copy hanya hasil build
+cp -r /tmp/konxc-deploy/* .
+
+# 7. Tambahkan .nojekyll
+touch .nojekyll
+
+# 8. Commit dan push
+git add -A
+git commit -m "Deploy: $(date '+%Y-%m-%d %H:%M:%S')"
+git push -u origin gh-pages
 
-# 7. Kembali ke branch main
+# 9. Kembali ke main
 git checkout main
+
+# 10. Cleanup
+rm -rf /tmp/konxc-deploy
 ```
 
 ## 🔧 Troubleshooting
@@ -84,34 +111,61 @@ Pastikan Anda berada di direktori root proyek (yang berisi file package.json).
 chmod +x scripts/deploy-manual.sh
 ```
 
+### Error: "Your local changes would be overwritten"
+```bash
+# Commit perubahan di main terlebih dahulu
+git add .
+git commit -m "Your commit message"
+```
+
 ### Website tidak update setelah deploy
-- GitHub Pages membutuhkan waktu beberapa menit untuk update
+- GitHub Pages membutuhkan waktu 2-5 menit untuk update
 - Pastikan branch `gh-pages` sudah di-push dengan benar
+- Clear browser cache (Ctrl+F5 atau Cmd+Shift+R)
 - Periksa pengaturan GitHub Pages di repository settings
 
 ## 📁 Struktur Branch
 
-- **main**: Branch utama untuk development
-- **gh-pages**: Branch untuk deployment (otomatis dibuat oleh script)
+- **main**: Branch utama untuk development (berisi source code lengkap)
+- **gh-pages**: Branch untuk deployment (hanya berisi hasil build dari `dist/`)
+
+### Contoh isi branch gh-pages:
+```
+gh-pages/
+├── _astro/           # CSS dan assets yang di-bundle
+│   └── index.*.css
+├── .nojekyll        # File untuk GitHub Pages
+├── CNAME            # Custom domain (jika ada)
+├── favicon.svg      # Favicon
+├── index.html       # HTML pages
+└── robots.txt       # Robots.txt
+```
+
+**Tidak ada**: `package.json`, `node_modules`, `src/`, `astro.config.mjs`, dll.
 
 ## 🔄 Workflow Development
 
 1. **Development**: Buat perubahan di branch `main`
 2. **Testing**: Test lokal dengan `pnpm dev`
-3. **Deploy**: Jalankan script deploy manual
-4. **Verification**: Periksa website di https://www.konxc.space
+3. **Build**: Test build dengan `pnpm build`
+4. **Deploy**: Jalankan script deploy manual
+5. **Verification**: Periksa website di https://www.konxc.space
 
 ## 📝 Catatan Penting
 
-- Script akan otomatis membuat branch `gh-pages` jika belum ada
-- Script akan otomatis kembali ke branch `main` setelah deploy
-- Pastikan tidak ada perubahan yang belum di-commit sebelum deploy
-- Website akan tersedia di https://www.konxc.space setelah deploy
+- ✅ Script menggunakan temporary directory untuk keamanan
+- ✅ Branch gh-pages selalu dibersihkan sebelum deploy baru
+- ✅ Hanya hasil build yang di-deploy, tidak ada source code
+- ✅ File `.nojekyll` ditambahkan otomatis
+- ✅ Script akan kembali ke main setelah deploy
+- ⚠️ Pastikan tidak ada perubahan yang belum di-commit sebelum deploy
+- ⚠️ Website akan tersedia di https://www.konxc.space setelah 2-5 menit
 
 ## 🆘 Support
 
 Jika mengalami masalah:
 1. Periksa troubleshooting di atas
 2. Pastikan semua prerequisites terinstall
 3. Periksa log error yang muncul
-4. Hubungi tim development jika masalah berlanjut
+4. Lihat `docs/TROUBLESHOOTING.md` untuk masalah umum
+5. Hubungi tim development jika masalah berlanjut

docs/QUICK_REFERENCE.md

@@ -3,20 +3,12 @@
 ## 🚀 Quick Deploy Commands
 
 ```bash
-# Linux/macOS
-./scripts/deploy-manual.sh
-
-# Windows (Git Bash/WSL)
-./scripts/deploy-manual.bat
-
-# Manual (if scripts fail)
-git checkout main && git pull origin main
-pnpm install && pnpm run build
-git checkout gh-pages && cp -r dist/* .
-git add . && git commit -m "Deploy: $(date)"
-git push origin gh-pages && git checkout main
+# Semua Platform (Linux/macOS/Windows Git Bash)
+bash ./scripts/deploy-manual.sh
 ```
 
+**Important**: Branch gh-pages hanya berisi hasil build, tidak ada source code!
+
 ## 🔧 Development Commands
 
 ```bash