CONTRIBUTING.vi.md

Đóng góp cho Youwee

Chúng tôi hoan nghênh mọi đóng góp! Đây là cách bạn có thể giúp.

Bắt đầu

1. Fork repository
2. Tạo nhánh tính năng từ main: git checkout main && git pull origin main && git checkout -b feature/tinh-nang-moi
3. Cài đặt pre-commit hook (khuyến nghị):

   cp scripts/pre-commit .git/hooks/ && chmod +x .git/hooks/pre-commit

4. Thực hiện thay đổi
5. Chạy tests và linting:

   bun run lint
   bun run build
   cd src-tauri && cargo check

6. Commit thay đổi: git commit -m 'feat: thêm tính năng mới'
7. Push lên nhánh: git push origin feature/tinh-nang-moi
8. Mở Pull Request với base branch là main

Quy trình nhánh và Pull Request

• Luôn tách nhánh từ main mới nhất trước khi bắt đầu làm.
• Đặt tên nhánh rõ ràng và tập trung, ví dụ feature/browser-extension-docs hoặc fix/download-path.
• Nếu Pull Request bị stale, hãy cập nhật nhánh của bạn với main trong quá trình làm.
• Khi mở Pull Request, chọn main làm base branch và nhánh feature/fix của bạn làm compare branch.
• Không merge trực tiếp vào main; hãy dùng Pull Request để thay đổi được review.

Quy ước Commit

Chúng tôi tuân theo Conventional Commits:

• feat: - Tính năng mới
• fix: - Sửa lỗi
• docs: - Thay đổi tài liệu
• style: - Thay đổi style code (formatting, v.v.)
• refactor: - Tái cấu trúc code
• test: - Thêm hoặc cập nhật tests
• chore: - Công việc bảo trì

Mẹo phát triển

• Chạy bun run tauri dev để hot-reload khi phát triển
• Thay đổi Frontend phản ánh ngay lập tức
• Thay đổi Rust cần biên dịch lại (tự động ở chế độ dev)

Code Style

• Sử dụng TypeScript cho code frontend
• Tuân theo các pattern và convention hiện có
• Sử dụng Biome để lint và format
• Giữ component nhỏ và tập trung

Hướng dẫn Pull Request

• Giữ PR tập trung vào một tính năng hoặc sửa lỗi
• Viết commit message rõ ràng theo quy ước
• Cập nhật tài liệu nếu cần
• Test kỹ các thay đổi trước khi submit