Contributing

🤝 Đóng góp / Contributing

Trước hết, cảm ơn bạn đã cân nhắc đóng góp cho pilo-masterkit! Chính những đóng góp của cộng đồng làm cho không gian nguồn mở trở thành một nơi tuyệt vời để học hỏi, truyền cảm hứng và sáng tạo.

1. Làm thế nào để đóng góp? / How Can I Contribute?

Báo cáo lỗi / Reporting Bugs

• Kiểm tra Issues để xem lỗi đã được báo cáo chưa.
• Nếu chưa, hãy tạo issue mới bằng mẫu Bug report.

Đề xuất cải tiến / Suggesting Enhancements

• Kiểm tra Issues để xem đã có ai đề xuất chưa.
• Nếu chưa, hãy tạo issue mới bằng mẫu Feature request.

Pull Requests

1. Fork repository về tài khoản của bạn.
2. Clone bản fork về máy cục bộ.
3. Tạo branch mới cho công việc của bạn (ví dụ: feat/new-rule-kit).
4. Thực hiện thay đổi và thêm test nếu có thể.
5. Đảm bảo các test đều vượt qua (npm test).
6. Commit thay đổi sử dụng Conventional Commits.
7. Push branch lên bản fork của bạn.
8. Gửi Pull Request vào branch main của repository gốc.

2. Tiêu chuẩn / Standards

• Conventional Commits: Mỗi commit phải tuân thủ feat:, fix:, docs:, v.v.
• Hỗ trợ song ngữ (Bilingual Support): Tất cả tài liệu phải được cung cấp bằng cả Tiếng Việt và Tiếng Anh.
• Bảo mật (Security): Tuyệt đối không commit bí mật hoặc dữ liệu nhạy cảm. Mọi đóng góp đều được quét mã độc.

3. Quy trình đánh giá PR / PR Review Process

• Mọi PR đều cần ít nhất một sự phê duyệt từ người duy trì.
• Các kiểm tra CI phải vượt qua.
• Chúng tôi có thể yêu cầu thay đổi hoặc làm rõ trước khi merge.

Cảm ơn sự hỗ trợ của bạn! / Thank you for your help!

---

⬅️ Trước: Bảo mật / Security | Tiếp theo: Báo lỗi / Report Bug ➡️