Báo cáo Preptember 2025: GitFichas hỗ trợ đa ngôn ngữ
Chúng ta đã bước vào giữa tháng 9 và đây là báo cáo của tôi cho tuần thứ hai của Preptember!
Tóm tắt: Đã có một PR lớn để hoàn thành vấn đề hỗ trợ ngôn ngữ trong GitFichas và một vài PR nhỏ khác.
Cuối cùng, tôi đã cập nhật hỗ trợ ngôn ngữ với sự trợ giúp của GitHub Copilot trong chế độ Agent, giờ đây GitFichas có khả năng hỗ trợ nhiều ngôn ngữ thay vì chỉ tiếng Bồ Đào Nha và tiếng Anh, đây là một chiến thắng lớn cho việc địa phương hóa.
Si hablas español… chúng tôi đang tìm kiếm sự đóng góp trong việc dịch sang tiếng Tây Ban Nha. Nếu bạn nói các ngôn ngữ khác, chúng tôi cũng rất hoan nghênh!
Tóm tắt lại
Trong tuần trước, tôi đã bắt đầu Preptember bằng cách sửa một vấn đề lớn trong GitFichas, nơi mà các đồ thị Mermaid không được hiển thị đúng trong trình duyệt. Giải pháp là chuyển từ việc render trên phía client sang việc tiền tạo các tệp SVG bằng CLI của Mermaid.
Tôi cũng đã thêm nhiều chức năng mới bao gồm một script cấu hình chỉ với một lệnh, hướng dẫn của GitHub Copilot cho các nhà đóng góp, tạo SVG tự động và cải thiện tài liệu. Mục tiêu là chuẩn bị GitFichas cho sự gia tăng đóng góp từ Hacktoberfest, làm cho nó trở nên thân thiện và dễ dàng để đóng góp hơn.
Các vấn đề đã đóng và pull requests đã thực hiện
Dưới đây là danh sách công việc đã thực hiện trong cuối tuần này:
- Issue #204: Cập nhật lựa chọn ngôn ngữ;
- PR #205: PR này đã thực hiện hỗ trợ cho nhiều ngôn ngữ và đóng vấn đề trên 🎉;
- PR #207: đã cập nhật nội dung trang liên hệ bằng tiếng Bồ Đào Nha và tiếng Anh;
- PR #206: Sửa một lỗi logic nhỏ được giới thiệu trong một PR của cuối tuần trước cho việc render Mermaid trong trình duyệt.
- PR #208: Điều chỉnh cách render của các thẻ.
Hãy chuẩn bị cho một câu chuyện thú vị…
Sử dụng Copilot trong chế độ Agent và vibe coding
Lần đầu tiên tôi đã để Copilot không chỉ thực hiện phần lớn công việc mà còn tự đánh giá công việc của mình trong một PR.
Tôi không phải là fan của vibe coding, không thể đơn giản nhấn “Keep” cho tất cả các thay đổi mà AI thực hiện mà không suy nghĩ hai lần trước khi commit. Đầu óc tôi không chấp nhận điều đó.
Nhưng gần nhất với vibe coding mà tôi có thể làm là yêu cầu AI làm điều gì đó và sau đó xem xét, cho phản hồi cụ thể về những gì không hoạt động và yêu cầu sửa chữa những gì bị lỗi. Quá trình này hoạt động tốt nhưng chắc chắn không nhanh bằng việc chấp nhận mù quáng bất kỳ output nào tôi nhận được.
Dù sao đi nữa, các PR mà tôi đã thực hiện cuối tuần này mất khoảng 6 giờ làm việc không tập trung. Nếu tôi có sự tập trung hơn, có lẽ đã mất 4 giờ, nhưng là cuối tuần mà, phải không?!
Tôi có thể chắc chắn rằng nếu không có sự giúp đỡ từ AI, việc viết mã mới, tái cấu trúc mã đã có, kiểm tra, xem trước các bản triển khai, điều chỉnh và các trường hợp biên bị bỏ quên, có lẽ sẽ mất khoảng hai ngày để hoàn thành.
Không chỉ vậy, điều đó có thể đồng nghĩa với việc triển khai lên môi trường sản xuất sẽ phải chờ đến cuối tuần sau vì tôi muốn có thêm thời gian để xem xét công việc của mình trước khi thực hiện merge pull request.
Sử dụng Copilot như một người đánh giá pull request
Và nói về việc đánh giá, đây là lần đầu tiên tôi có Copilot thực hiện việc đánh giá cho tôi và thật sự là thú vị để nói ít nhất.
Nó đã gọi sự chú ý của tôi đến tài liệu mà tôi quên cập nhật, cũng như thực tế là PR của tôi không tuân theo hướng dẫn của dự án. 😂
Để tôi giải thích. Cho đến nay, GitFichas chỉ hỗ trợ hai ngôn ngữ: tiếng Bồ Đào Nha và tiếng Anh. Và cách mà việc địa phương hóa được triển khai không cho phép dễ dàng thêm các bản dịch khác. Vì vậy, một phần của tài liệu dự án đã làm rõ rằng nội dung của trang web chỉ có bằng hai ngôn ngữ ban đầu này.
Vì vậy, tôi chắc chắn đã cười khi Copilot chỉ ra rằng PR của tôi đang đi ngược lại với hướng dẫn của dự án là chỉ hỗ trợ tiếng Bồ Đào Nha và tiếng Anh.
Nhận xét này đã như một nhắc nhở tốt để không chỉ cập nhật tài liệu (điều mà tôi đã thực hiện nhờ vào một nhận xét tương tự) mà còn cả hướng dẫn của Copilot vì chúng cũng được sử dụng trong các đánh giá ngoài chat trong VS Code.
Các bước tiếp theo
Danh sách các vấn đề cho những cuối tuần tới là như sau:
- Issue #173 trong GitFichas: Tạo một hình ảnh xem trước cho mỗi thẻ để dễ dàng chia sẻ;
- Issue #63 trong GitFichas: Tạo các chủ đề khác nhau để mỗi thẻ trông khác nhau một chút so với những thẻ khác.
Tôi cũng dự định quay lại các pull requests mà tôi đã bỏ qua trong suốt năm.
Cụ thể là #166 trong kho lưu trữ của PyLadiesCon. Mariatta nếu bạn đang đọc điều này: tôi xin lỗi vì đã chậm trễ trong việc xử lý nó, cuối tuần tới tôi sẽ giải quyết các xung đột để chúng ta có thể thực hiện merge.
Một lưu ý bên lề: Bạn đã xem danh sách pull requests của bạn gần đây chưa? Danh sách của tôi dường như không bao giờ về không. 😂
Hãy cùng nhau tiến bước
Nếu bạn đang nghĩ đến việc đóng góp cho mã nguồn mở trong dịp Hacktoberfest, hãy bắt đầu tìm kiếm các dự án mà bạn muốn đóng góp. Hãy lập danh sách các dự án, fork và clone các kho lưu trữ, kiểm tra hướng dẫn đóng góp và bắt đầu chuẩn bị vì tháng 10 sắp đến gần.
Như thường lệ, hãy kiểm tra GitFichas trên GitHub và nếu bạn cần giúp đỡ về các đóng góp của mình, hãy gửi cho tôi một tin nhắn qua các kênh xã hội khác nhau! 🎉
Các thực hành tốt nhất
- Cải tiến tài liệu: Luôn cập nhật tài liệu dự án để phản ánh những thay đổi mới nhất.
- Gợi ý cho mọi người đóng góp: Khuyến khích cộng đồng tham gia vào việc dịch thuật và cải thiện mã nguồn.
Những cạm bẫy thường gặp
- Quá phụ thuộc vào AI: Đừng quên rằng AI chỉ là một công cụ hỗ trợ; sự sáng tạo và quyết định của bạn vẫn rất quan trọng.
Mẹo hiệu suất
- Tối ưu hóa quy trình làm việc: Sử dụng các công cụ như GitHub Copilot để tăng tốc quy trình phát triển mà không làm giảm chất lượng.
Khắc phục sự cố
- Kiểm tra kỹ lưỡng: Đảm bảo rằng tất cả các thay đổi đều được kiểm tra trước khi triển khai.
Câu hỏi thường gặp (FAQ)
- Làm thế nào để bắt đầu với GitFichas? Bạn có thể bắt đầu bằng cách kiểm tra tài liệu và tham gia cộng đồng trên GitHub.
- Có thể đóng góp bằng ngôn ngữ nào? Bạn có thể đóng góp bằng bất kỳ ngôn ngữ nào, không chỉ tiếng Bồ Đào Nha và tiếng Anh.
