Contributing

Chào mừng contributor!

Islam.io.vn là dự án cộng đồng. Mọi đóng góp đều có giá trị — từ sửa typo trong docs đến thêm dữ liệu thánh đường hay cải thiện API.

Cách đóng góp

1. Báo cáo lỗi

Nếu bạn tìm thấy lỗi trong API, dữ liệu sai, hoặc docs không rõ:

1. Kiểm tra Issues xem đã có ai báo chưa
2. Mở issue mới với template phù hợp
3. Mô tả rõ: lỗi gì, reproduce như thế nào, expected behavior

2. Đóng góp dữ liệu thánh đường

Đây là đóng góp quan trọng nhất hiện tại:

1. Fork repo islamiovn/islamiovn
2. Chỉnh sửa file data/mosques.json
3. Thêm thông tin thánh đường theo schema
4. Tạo Pull Request với mô tả rõ ràng

Lưu ý khi thêm dữ liệu:

• Kiểm tra tọa độ GPS chính xác (dùng Google Maps)
• Xác minh địa chỉ thực tế
• Không thêm thông tin chưa được xác minh

3. Cải thiện documentation

Docs luôn có thể tốt hơn:

1. Fork repo
2. Chỉnh sửa file .mdx trong content/docs/
3. Tạo Pull Request

4. Đóng góp code

Trước khi code:

1. Đọc Architecture Overview
2. Mở issue để thảo luận approach trước
3. Assign issue cho bản thân

Setup môi trường:

git clone https://github.com/islamiovn/islamiovn.git
cd islamiovn
npm install
npm run dev

Code Standards

• TypeScript cho tất cả code mới
• Biome cho linting và formatting (npm run lint, npm run format)
• Commit message theo Conventional Commits

feat: add prayer times for Hanoi
fix: correct mosque coordinates in An Giang
docs: update API overview
data: add 5 mosques in Ho Chi Minh City

Pull Request Process

1. Fork → Branch → Commit → Push → PR
2. PR title rõ ràng, mô tả đầy đủ
3. Đợi review từ maintainer (thường trong 48h)
4. Address feedback nếu có
5. Merge sau khi approved

Code of Conduct

• Tôn trọng mọi contributor
• Không phân biệt đối xử
• Thảo luận dựa trên kỹ thuật, không cá nhân
• Giữ môi trường thân thiện và chuyên nghiệp

Liên hệ

• GitHub Issues: github.com/islamiovn/islamiovn/issues
• Email: contribute@islam.io.vn (sắp ra)

Jazakallahu Khayran cho mọi đóng góp! 🤲