Đóng góp cho BeeWare Docs Tools¶

Có rất nhiều cách để đóng góp cho BeeWare Docs Tools và BeeWare nói chung. Các hướng dẫn này bao gồm tất cả những gì bạn cần biết để đóng góp.

Tôi có thể đóng góp được không?¶

Đúng vậy! Chúng tôi có cơ hội cho mọi người ở mọi trình độ kinh nghiệm cùng tham gia đóng góp. Dù đây là lần đầu tiên bạn tham gia đóng góp cho mã nguồn mở hay bạn đã làm việc này nhiều năm, chúng tôi đều có những cơ hội phù hợp với bạn.

Đây có phải là lần đầu tiên bạn đóng góp cho một dự án mã nguồn mở không? Chúng tôi sẵn sàng hỗ trợ bạn! Chúng tôi có những lời khuyên dành cho những người mới bắt đầu đóng góp để giúp bạn vượt qua những lo lắng và băn khoăn ban đầu.

Sử dụng trí tuệ nhân tạo (AI) và các công cụ tự động

Dự án BeeWare không khuyến khích cũng không cấm việc sử dụng các công cụ AI khi đóng góp. Tuy nhiên, nếu bạn sử dụng công cụ AI, chúng tôi yêu cầu bạn phải khai báo rõ những công cụ mà bạn đã sử dụng. Chính sách về AI của chúng tôi nêu rõ các nghĩa vụ của bạn.

Tôi có thể làm gì?¶

Khắc phục sự cố ¶

Đóng góp rõ ràng nhất mà bạn có thể thực hiện là viết mã để khắc phục một sự cố đã biết.

Thực hiện một tính năng mới ¶

BeeWare Docs Tools có thiếu tính năng nào mà bạn mong muốn không? Bạn có thể thực hiện tính năng mới.

Viết tài liệu ¶

Một tính năng chỉ được coi là hoàn thiện khi đã được ghi chép đầy đủ. Viết tài liệu là một cách đóng góp mà không cần phải viết mã.

Phân loại vấn đề ¶

Mỗi khi có ai đó báo cáo một sự cố mới, sự cố đó cần được phân loại. Việc phân loại sự cố bao gồm việc thu thập thông tin do người báo cáo cung cấp và cố gắng tái hiện lại vấn đề mà họ mô tả.

Xem xét yêu cầu kéo ¶

Sau khi yêu cầu hợp nhất được gửi đi, nó cần được xem xét trước khi có thể được hợp nhất. Dù bạn có am hiểu sâu sắc về nội dung hay không, chắc chắn vẫn có cách để bạn có thể góp phần xem xét yêu cầu hợp nhất.

Đề xuất tính năng mới ¶

Bạn có đề xuất hay ý tưởng nào về một tính năng mới cho một trong các công cụ của BeeWare không? Bạn có thể đề xuất một tính năng mới để chúng tôi xem xét.

Dịch nội dung ¶

BeeWare cung cấp nhiều tài liệu bằng nhiều ngôn ngữ khác nhau. Nếu bạn thông thạo một ngôn ngữ khác ngoài tiếng Anh, bạn có thể giúp dịch nội dung.

Sử dụng các công cụ ¶

Bạn có ý tưởng nào về một ứng dụng được phát triển bằng Toga không? Bạn có ứng dụng nào hiện có có thể được đóng gói bằng Briefcase không? Bạn có thể sử dụng các công cụ và chia sẻ phản hồi về trải nghiệm của mình.

Làm thế nào để tôi có thể đóng góp?¶

Thiết lập môi trường phát triển ¶

Trước khi bắt đầu đóng góp cho BeeWare, bạn cần thiết lập môi trường phát triển.

Tái hiện sự cố ¶

Trước khi khắc phục một sự cố, bạn cần xác minh xem sự cố đó có tồn tại hay không. Việc tái hiện sự cố cũng là một phần quan trọng trong quá trình phân loại.

Làm việc từ một nhánh ¶

Khi chuẩn bị gửi đóng góp, hãy luôn làm việc trên một nhánh.

Tránh tình trạng mở rộng phạm vi ¶

Điều quan trọng là phải duy trì sự tập trung và tránh tình trạng mở rộng phạm vi trong phần đóng góp của bạn.

Đề xuất tính năng mới ¶

Bạn hãy làm theo các bước sau để đề xuất một tính năng mới.

Viết, chạy và kiểm thử mã nguồn ¶

Để cập nhật hoặc đóng góp mã nguồn, bạn cần viết, chạy và kiểm thử mã nguồn của mình.

Tài liệu hướng dẫn cài đặt ¶

Để cập nhật hoặc đóng góp cho tài liệu, bạn cần phải có khả năng xây dựng tài liệu.

Viết tài liệu ¶

Để đóng góp tài liệu, bạn sẽ viết nội dung mới hoặc cập nhật nội dung hiện có.

Thêm ghi chú thay đổi ¶

Mỗi yêu cầu kéo (pull request) phải kèm theo một ghi chú thay đổi.

Gửi yêu cầu pull ¶

Khi các thay đổi của bạn đã sẵn sàng, bạn sẽ gửi yêu cầu pull để được xem xét.

Viết đánh giá ¶

Nếu bạn thấy thoải mái, bạn có thể đánh giá đóng góp của người khác.

Dịch nội dung ¶

BeeWare sử dụng Weblate để dịch thuật, việc này cần thực hiện một vài bước để bắt đầu.

Gửi báo cáo sự cố mới ¶

Nếu bạn gặp phải một vấn đề mới hoặc lỗi, bạn nên gửi báo cáo sự cố.

Tiếp theo sẽ ra sao?¶

Xem xét yêu cầu kéo ¶

Khi một yêu cầu kéo (pull request) được gửi đi, bước tiếp theo là quá trình xem xét PR.

Quy trình phát hành ¶

Các đóng góp đã được hợp nhất sẽ trải qua quy trình phát hành.

Chính sách¶

Chính sách về Trí tuệ nhân tạo ¶

Chính sách của BeeWare về việc sử dụng Trí tuệ nhân tạo tạo sinh (Generative AI), các Mô hình ngôn ngữ quy mô lớn (Large Language Models) và các công cụ tự động khác khi đóng góp.

Hướng dẫn phong cách¶

Hướng dẫn phong cách mã nguồn ¶

Dưới đây là các hướng dẫn về việc đóng góp mã nguồn cho các dự án BeeWare.

Hướng dẫn phong cách tài liệu ¶

Dưới đây là các hướng dẫn về việc đóng góp tài liệu cho các dự án BeeWare.