Xử lý lỗi

Python là một ngôn ngữ lập trình đã trưởng thành và có uy tín về sự ổn định. Để giữ vững uy tín đó, các nhà phát triển muốn biết về mọi khiếm khuyết mà bạn phát hiện trong Python.

Đôi khi, tự sửa lỗi rồi gửi bản vá cho Python có thể nhanh hơn vì quy trình gọn hơn và ít người tham gia hơn. Tìm hiểu cách đóng góp.

Lỗi tài liệu

Nếu phát hiện lỗi trong tài liệu này hoặc muốn đề xuất cải tiến, vui lòng gửi báo cáo trên issue tracker. Nếu có đề xuất về cách khắc phục, hãy kèm luôn vào báo cáo.

Nếu lỗi hoặc đề xuất cải tiế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 sang kho của bản dịch.

Bạn cũng có thể mở một chủ đề thảo luận trên Documentation Discourse forum.

Nếu phát hiện lỗi ở giao diện (HTML / CSS / JavaScript) của tài liệu, vui lòng gửi báo cáo trên python-doc-theme issue tracker.

Xem thêm

Documentation bugs

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.

Helping with Documentation

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.

Documentation Translations

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

Báo cáo sự cố cho chính Python nên gửi qua GitHub issue tracker (https://github.com/python/cpython/issues). Tracker này cung cấp một biểu mẫu web để bạn nhập các thông tin cần thiết và gửi đến 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 ai đó báo cáo chưa. Ngoài việc tiết kiệm thời gian cho nhà phát triển, ưu điểm của cách này là bạn sẽ biết tình hình khắc phục đến đâu: có thể sự cố đã được sửa cho bản phát hành tiếp theo, hoặc cần bổ sung thêm thông tin (trong trường hợp đó, rất hoan nghênh nếu bạn cung cấp được!). Để kiểm tra, hãy dùng hộp tìm kiếm ở đầu trang issue tracker.

Nếu sự cố bạn muốn báo cáo chưa có trong danh sách, hãy đăng nhập GitHub. Nếu chưa có tài khoản, hãy tạo tài khoản mới qua liên kết "Sign up". Không thể gửi báo cáo lỗi ẩn danh.

Sau khi đã đăng nhập, bạn có thể gửi issue. Nhấp nút "New issue" trên thanh trên cùng để tạo báo cáo mới.

Biểu mẫu gồm hai trường: "Title" và "Comment".

Với trường "Title", hãy nhập mô tả thật ngắn gọn về sự cố; dưới mười từ là vừa đẹp.

Trong trường "Comment", hãy mô tả chi tiết vấn đề, bao gồm cả kết quả bạn mong đợi và kết quả thực tế đã xảy ra. Nhớ nêu rõ có module mở rộng nào liên quan hay không, cùng với nền tảng phần cứng và phần mềm đang dùng (kèm thông tin phiên bản nếu cần).

Mỗi báo cáo sẽ được một nhà phát triển xem xét để xác định cần làm gì để khắc phục vấn đề. Bạn sẽ nhận được cập nhật mỗi khi có thao tác mới trên issue đó.

Xem thêm

How to Report Bugs Effectively

Bài viết trình bày chi tiết cách tạo một báo cáo lỗi hữu ích, mô tả những loại thông tin nào có ích và vì sao chúng có ích.

Bug Writing Guidelines

Thông tin về cách viết báo cáo lỗi tốt. Một phần nội dung dành riêng cho dự án Mozilla, nhưng vẫn trình bày những thông lệ tốt có thể áp dụng chung.

Bắt đầu tự mình đóng góp cho Python

Ngoài việc báo cáo các lỗi bạn phát hiện, bạn còn được khuyến khích gửi bản vá để tự sửa chúng. Thông tin về cách bắt đầu vá lỗi Python có trong Python Developer's Guide. Nếu còn thắc mắc, core-mentorship mailing list là nơi thân thiện để giải đáp mọi câu hỏi liên quan đến quy trình khắc phục sự cố trong Python.