maxubrq
Tuyển tập · Software
Tập I

Instant Better Code

Hay: code như một cuộc trò chuyện với người đọc tiếp theo, không phải instruction cho máy.

○Đang tiến hành · 13 chương· 13 đang soạn
Thư từ tác giả

Hầu hết dev học cách viết code chạy được. Đó là mức thấp nhất mà ngôn ngữ ép, và là chỗ mà phần lớn việc dạy dừng lại. Code chạy được và code đọc được không phải cùng một thứ, và khoảng cách giữa hai thứ đó là nơi gần như toàn bộ cost thật của team nằm: trong thời gian đọc lại, debug, review, và giải thích những đoạn code mà không ai cố ý làm cho khó hiểu.

Series này dành cho dev đã làm sản phẩm thật và đã, ở đâu đó trên đường đi, nhận ra rằng "nó chạy được" là chưa đủ. Nó nói về audience thứ hai của mỗi dòng code: người sẽ phải đọc nó, thường trong điều kiện tệ hơn lúc bạn viết. Máy không cần bạn giúp. Người đọc tiếp theo thì cần.

Mỗi chương lấy một thói quen, một cơ chế, hoặc một lỗi, và hỏi cùng một câu: nếu đoạn code này được viết cho người sẽ đọc nó lúc 11 giờ đêm ngày mai, thay vì cho compiler tối nay, nó sẽ trông như thế nào?

— m., May 2026

Bản đồ đọc

Đã đọc 0
  1. I
    The Two Audiences(bản nháp)
    20 Th5, 2026
    ·
  2. II
    Cognitive Load(bản nháp)
    20 Th5, 2026
    ·
  3. III
    Friction Map(bản nháp)
    20 Th5, 2026
    ·
  4. IV
    Naming(bản nháp)
    20 Th5, 2026
    ·
  5. V
    Function Length và Single Responsibility(bản nháp)
    20 Th5, 2026
    ·
  6. VI
    Comments(bản nháp)
    20 Th5, 2026
    ·
  7. VII
    Error Handling(bản nháp)
    20 Th5, 2026
    ·
  8. VIII
    Structure và Layout(bản nháp)
    20 Th5, 2026
    ·
  9. IX
    Avoid Clever(bản nháp)
    20 Th5, 2026
    ·
  10. X
    Maintainability(bản nháp)
    20 Th5, 2026
    ·
  11. XI
    Tradeoffs(bản nháp)
    21 Th5, 2026
    ·
  12. XII
    Code Review như một Ngôn ngữ(bản nháp)
    21 Th5, 2026
    ·
  13. XIII
    Khi nào thì đủ(bản nháp)
    21 Th5, 2026
    ·
Tập này được mở từ May 2026. Vẫn đang được viết.