Nhiều năm liền mình giải cùng một vấn đề hai lần. Không phải vì nó khó, mà vì mình đã quên lần đầu giải nó thế nào. Ghi chép đã sửa được điều đó — và bất ngờ thay, giúp mình trở thành một kỹ sư rõ ràng hơn.
Ghi chép là cho chính mình trong tương lai#
Người đọc của một ghi chép công việc không phải là cả internet. Đó là bạn, sáu tháng sau, lúc 11 giờ đêm, nhìn chằm chằm vào cùng một stack trace. Hãy viết cho người đó: cái gì hỏng, bạn đã thử gì, cái gì thật sự hiệu quả, và vì sao.
Một định dạng đủ nhỏ để duy trì#
Mọi ghi chép của mình gói gọn trong bốn mục. Nếu mất hơn mười phút, có lẽ đó là một bài viết chứ không phải ghi chép.
- Bối cảnh — một hai câu về tình huống.
- Vấn đề — triệu chứng, đúng như nó xuất hiện.
- Cách giải — cách sửa, kèm đoạn code hoặc link.
- Vì sao — cơ chế bên dưới. Đây là phần bạn sẽ cảm ơn chính mình.
Từ ghi chép đến bài viết#
Phần lớn bài trên blog này bắt đầu từ vài ghi chép cứ chỉ về cùng một ý. Khi ba ghi chép có chung một "vì sao", đó là chủ đề đáng viết thành bài tử tế.
Bạn chưa thật sự hiểu một thứ cho đến khi giải thích được sự đánh đổi, chứ không chỉ cách sửa.
Học công khai, một cách nhẹ nhàng#
Chia sẻ không cần ồn ào. Hãy đăng những ghi chép có thể giúp ai đó tiết kiệm một buổi chiều, thừa nhận những gì mình còn chưa chắc, và cập nhật bài khi biết thêm. Thành thật về sự không chắc chắn là điểm mạnh, không phải điểm yếu.
- Ghi lại khi vấn đề còn mới.
- Giữ phần "vì sao" dù cách sửa chỉ một dòng.
- Liên kết các ghi chép liên quan với nhau.
- Xem lại hằng tháng và nâng các chủ đề lặp lại thành bài viết.