B20:41
I used to write bug reports that just said 'it crashes'.
Tôi từng viết báo cáo lỗi chỉ vỏn vẹn 'nó bị treo'.
Developers would reply asking for more details right away.
Lập trình viên sẽ trả lời ngay, yêu cầu thêm chi tiết.
That meant wasted time for everyone.
Điều đó có nghĩa là lãng phí thời gian cho tất cả mọi người.
Now I start with a clear summary of the problem.
Bây giờ tôi bắt đầu bằng một bản tóm tắt rõ ràng về vấn đề.
Then I list the steps to reproduce the bug.
Sau đó tôi liệt kê các bước để tái hiện lỗi.
For example: open the app, click 'New Order', then type a long product name.
Ví dụ: mở ứng dụng, nhấp 'Đơn hàng mới', sau đó gõ tên sản phẩm dài.
I also describe what I expected vs what happened.
Tôi cũng mô tả điều tôi mong đợi so với điều đã xảy ra.
Expected: the field accepts up to 100 characters.
Mong đợi: trường này chấp nhận tối đa 100 ký tự.
Actual: the app freezes when I type more than 50.
Thực tế: ứng dụng bị đứng khi tôi gõ hơn 50 ký tự.
I mention the device and version where it shows up.
Tôi đề cập đến thiết bị và phiên bản nơi lỗi xuất hiện.
Now developers can reproduce it without asking me twice.
Giờ đây lập trình viên có thể tái hiện lỗi mà không cần hỏi lại tôi.
They appreciate the clarity and I get faster fixes.
Họ đánh giá cao sự rõ ràng và tôi nhận được bản sửa lỗi nhanh hơn.
LI
Learning to Write a Bug Report That Developers Actually Thank Me For
by @linhdaily