Memulai

• Periksa apakah bug sudah dilaporkan di GitHub Issues
• Jika belum, buat issue baru dengan langkah reproduksi
• Tunggu konfirmasi sebelum mulai mengerjakan

Fork repository di github.com/wailsapp/wails/fork

Clone fork Anda:

git clone https://github.com/YOUR_USERNAME/wails.git
cd wails
git remote add upstream https://github.com/wailsapp/wails.git

Build Wails dan verifikasi Anda dapat mereproduksi bug:

cd v3
go build -o ../wails3 ./cmd/wails3

# Reproduksi bug untuk memahaminya

Buat branch untuk perbaikan Anda:

git checkout -b fix/issue-123-window-crash

• Lakukan perubahan minimal yang diperlukan untuk memperbaiki bug
• Jangan refactor kode yang tidak terkait
• Tambah atau perbarui tes untuk mencegah regresi

# Lakukan perubahan Anda
# Tambahkan tes di file *_test.go

Jalankan tes untuk memastikan perbaikan berfungsi:

go test ./...

# Tes paket spesifik
go test ./pkg/application -v

# Jalankan dengan race detector
go test ./... -race

Commit dengan pesan yang jelas:

git commit -m "fix: prevent window crash when closing during initialization

Fixes #123"

Push dan buat PR:

git push origin fix/issue-123-window-crash

Di deskripsi PR Anda:

• Jelaskan bug dan akar masalah
• Deskripsikan perbaikan Anda
• Referensikan issue: “Fixes #123”
• Sertakan perilaku sebelum/sesudah

Tangani komentar review dan perbarui PR Anda sesuai kebutuhan.

• Buka GitHub Discussion atau issue
• Deskripsikan apa yang ingin Anda tambahkan dan alasannya
• Tunggu feedback maintainer sebelum mengimplementasikan
• Pastikan selaras dengan tujuan Wails

Fork repository di github.com/wailsapp/wails/fork

Clone fork Anda:

git clone https://github.com/YOUR_USERNAME/wails.git
cd wails
git remote add upstream https://github.com/wailsapp/wails.git

Build Wails dan verifikasi lingkungan Anda:

cd v3
go build -o ../wails3 ./cmd/wails3

# Jalankan tes untuk memastikan semuanya berfungsi
go test ./...

Buat branch yang deskriptif:

git checkout -b feat/window-transparency-support

• Ikuti Standar Coding kami
• Fokuskan perubahan pada fitur tersebut
• Tulis kode yang bersih dan terdokumentasi
• Tambahkan tes yang komprehensif

# Contoh: Menambahkan method window baru
# 1. Tambahkan ke interface window.go
# 2. Implementasikan di file platform (darwin, windows, linux)
# 3. Tambahkan tes
# 4. Perbarui dokumentasi

Tes fitur Anda:

# Unit test
go test ./pkg/application -v

# Integration test - buat aplikasi tes
cd ..
./wails3 init -n feature-test
cd feature-test
# Tambahkan kode menggunakan fitur baru Anda
../wails3 dev

• Tambahkan docstring ke semua API publik
• Perbarui dokumentasi relevan di /docs/src/content/docs/
• Tambahkan contoh jika applicable

Gunakan conventional commits:

git commit -m "feat: add window transparency support

- Add SetTransparent() method to Window API
- Implement for macOS, Windows, and Linux
- Add tests and documentation

Closes #456"

Push dan buat PR:

git push origin feat/window-transparency-support

Di PR Anda:

• Deskripsikan fitur dan use case
• Tampilkan contoh atau screenshot
• Daftarkan breaking change jika ada
• Referensikan diskusi/issue

Maintainer mungkin meminta perubahan. Bersabarlah dan kolaboratif.

• Menemukan docs yang outdated saat menggunakan Wails?
• Menyadari contoh atau penjelasan yang hilang?
• Ingin memperbaiki typo atau meningkatkan kejelasan?
• Periksa issue dokumentasi

Fork repository di github.com/wailsapp/wails/fork

Clone fork Anda:

git clone https://github.com/YOUR_USERNAME/wails.git
cd wails
git remote add upstream https://github.com/wailsapp/wails.git

Dokumentasi ada di /docs/src/content/docs/ dan dibangun dengan Astro:

cd docs
npm install
npm run dev

Buka http://localhost:4321/ untuk pratinjau perubahan secara live.

Buat branch untuk perubahan Anda:

git checkout -b docs/improve-window-api-examples

File dokumentasi ada di /docs/src/content/docs/:

# Edit file MDX
# Periksa pratinjau di browser Anda
# Pastikan format benar

Praktik Terbaik:

• Gunakan bahasa yang jelas dan ringkas
• Sertakan contoh kode praktis
• Tambahkan tautan ke bagian terkait
• Periksa ejaan dan tata bahasa
• Tes semua contoh kode

Periksa pratinjau live dan pastikan:

• Tautan berfungsi dengan benar
• Contoh kode akurat
• Format dirender dengan benar
• Tidak ada gambar atau referensi yang rusak

Commit dengan pesan yang jelas:

git commit -m "docs: add practical examples to Window API guide

- Add window positioning examples
- Include common patterns section
- Fix broken links to Event API"

Push dan buat PR:

git push origin docs/improve-window-api-examples

Di PR Anda:

• Deskripsikan docs apa yang Anda perbaiki
• Jelaskan mengapa perubahan membantu pengguna
• Sertakan screenshot jika ada perubahan visual

PR dokumentasi biasanya cepat direview dan di-merge!