Xử lý lỗi¶
Python là một ngôn ngữ lập trình lâu đời và đã khẳng định được uy tín về sự ổn định. Để duy trì uy tín này, các nhà phát triển mong muốn được biết về bất kỳ thiếu sót nào mà bạn tìm thấy trong Python.
Đôi khi việc tự sửa lỗi và đóng góp các bản vá cho Python sẽ nhanh hơn vì quy trình được tinh giản và ít phụ thuộc vào bên thứ ba hơn. Tìm hiểu cách để đóng góp.
Lỗi tài liệu¶
Nếu bạn tìm thấy lỗi trong tài liệu này hoặc muốn đề xuất cải thiện, vui lòng gửi báo cáo lỗi trên issue tracker. Nếu bạn có gợi ý về cách khắc phục, hãy đính kèm nội dung đó trong báo cáo.
Nếu lỗi hoặc đề xuất cải thiện liên quan đến bản dịch của tài liệu này, hãy gửi báo cáo đến repository của bản dịch.
Bạn cũng có thể mở một đề mục thảo luận trên diễn đàn thảo luận về tài liệu của chúng tôi trên Discourse.
Nếu bạn tìm thấy lỗi trong giao diện (HTML / CSS / JavaScript) của tài liệu, vui lòng gửi báo cáo lỗi trên hệ thống theo dõi lỗi python-doc-theme.
Xem thêm
- Lỗi tài liệu
Danh sách các lỗi tài liệu đã được gửi lên issue tracker của Python.
- Issue Tracking
Tổng quan về quy trình gửi đề xuất cải tiến qua issue tracker.
- Trợ giúp với Tài Liệu
Hướng dẫn toàn diện dành cho những ai muốn đóng góp cho tài liệu Python.
- Bản dịch Tài Liệu
Danh sách các trang GitHub phục vụ dịch tài liệu và đầu mối liên hệ chính của mỗi trang.
Sử dụng issue tracker của Python¶
Các báo cáo lỗi cho chính Python nên được gửi qua hệ thống theo dõi lỗi GitHub (https://github.com/python/cpython/issues). Hệ thống theo dõi lỗi GitHub cung cấp một web form cho phép nhập và gửi các thông tin liên quan đến các nhà phát triển.
Bước đầu tiên khi gửi báo cáo là xác định xem vấn đề đó đã được báo cáo hay chưa. Việc này không chỉ giúp tiết kiệm thời gian cho các nhà phát triển mà còn giúp bạn biết được những gì đã được thực hiện để khắc phục nó; có thể vấn đề đã được xử lý cho bản phát hành kế tiếp, hoặc đang cần thêm thông tin bổ sung (trong trường hợp đó, chúng tôi rất hoan nghênh nếu bạn có thể cung cấp!). Để thực hiện việc này, hãy tìm kiếm trên hệ thống bằng hộp tìm kiếm ở đầu trang.
Nếu vấn đề bạn đang báo cáo chưa có trong danh sách, hãy đăng nhập vào GitHub. Nếu bạn chưa có tài khoản GitHub, hãy tạo tài khoản mới bằng liên kết "Sign up". Không thể gửi báo cáo lỗi dưới danh nghĩa ẩn danh.
Sau khi đã đăng nhập, bạn có thể gửi một vấn đề. Nhấp vào nút "New issue" ở thanh trên cùng để báo cáo một vấn đề mới.
Biểu mẫu gửi bao gồm hai trường, tiêu đề "Title" và bình luận "Comment".
Tại trường "Title", hãy nhập một mô tả rất ngắn gọn về vấn đề; ít hơn mười từ là tốt nhất.
Tại trường "Comment", hãy mô tả chi tiết vấn đề, bao gồm những gì bạn mong đợi sẽ xảy ra và những gì đã thực sự xảy ra. Hãy nhớ ghi rõ liệu có liên quan đến bất kỳ mô-đun mở rộng nào không, cũng như nền tảng phần cứng và phần mềm bạn đang sử dụng (bao gồm cả thông tin phiên bản nếu phù hợp).
Mỗi báo cáo lỗi sẽ được một nhà phát triển xem xét để xác định những việc cần làm nhằm khắc phục vấn đề. Bạn sẽ nhận được thông báo cập nhật mỗi khi có một hành động được thực hiện đối với vấn đề đó.
Xem thêm
- Cách báo cáo lỗi hiệu quả
Bài viết đi sâu vào chi tiết về cách tạo một báo cáo lỗi hữu ích. Nội dung này mô tả loại thông tin nào là hữu ích và tại sao chúng lại hữu ích.
- ` Hướng dẫn viết báo cáo lỗi<https://bugzilla.mozilla.org/page.cgi?id=bug-writing.html>`_
Thông tin về cách viết một báo cáo lỗi tốt. Một số nội dung trong này dành riêng cho dự án Mozilla, nhưng có mô tả các quy tắc chung hữu ích.
Bắt đầu tự mình đóng góp cho Python¶
Ngoài việc chỉ báo cáo các lỗi mà bạn tìm thấy, chúng tôi cũng rất hoan nghênh bạn gửi các bản vá để khắc phục chúng. Bạn có thể tìm thêm thông tin về cách bắt đầu thực hiện các bản vá cho Python trong phần Python Developer's Guide. Nếu bạn có thắc mắc, core-mentorship mailing list là một nơi thân thiện để nhận câu trả lời cho bất kỳ và tất cả các câu hỏi liên quan đến quy trình khắc phục các vấn đề trong Python.