Một thay đổi phần mềm thường bắt đầu bằng yêu cầu khá nhỏ: sửa một nút bấm, bổ sung trường dữ liệu hoặc xử lý một lỗi hiển thị. Tuy vậy, trong lúc làm việc, rất dễ tiện tay đổi tên biến và sắp xếp lại cả tệp. Khi tất cả nằm trong một commit, người đọc phải đoán đâu là mục đích chính. Chia commit theo ý nghĩa giúp giảm công việc đoán đó.

Chọn một câu hỏi cho mỗi thay đổi
Trước khi sửa mã, hãy thử viết một câu mô tả kết quả mong muốn. Ví dụ: khi người dùng bỏ trống tên, biểu mẫu cần giải thích cách sửa. Câu này tạo ranh giới cho công việc. Việc thay màu toàn bộ giao diện có thể để sang thay đổi khác, kể cả khi nó nằm trong cùng tệp. Một commit không nhất thiết nhỏ về số dòng, nhưng nên có một lý do rõ ràng.
Sau khi hoàn thành, đọc phần khác biệt thay vì chỉ nhìn màn hình ứng dụng. Các dòng ghi log tạm, chú thích thử nghiệm và khoảng trắng không liên quan thường lộ ra ở bước này. Với Git, trạng thái vùng làm việc và vùng chuẩn bị commit là hai lớp riêng. Đưa từng nhóm thay đổi vào vùng chuẩn bị giúp kiểm soát chính xác thứ sắp được ghi lại.
git status
git diff
git diff --staged
Thông điệp là điểm bắt đầu để đọc mã
Một thông điệp như “sửa vài thứ” không cho biết điều gì đã thay đổi. Có thể thay bằng “Hiển thị hướng dẫn khi tên bị bỏ trống”. Phần giải thích phía sau nên nói vì sao cách xử lý được chọn, nhất là khi tồn tại một giới hạn nghiệp vụ. Không cần kể lại từng dòng mã; người đọc có thể xem chúng trong phần khác biệt.
- Kiểm tra chỉ những tệp cần thiết đã được đưa vào commit.
- Chạy phép kiểm thử liên quan đến hành vi vừa sửa.
- Đọc lại thay đổi từ góc nhìn người chưa biết yêu cầu.
Đừng biến lịch sử thành mục tiêu riêng
Trong nhánh cá nhân chưa chia sẻ, việc sắp xếp lại commit có thể giúp câu chuyện dễ hiểu hơn. Với nhánh đã có người khác sử dụng, cần thống nhất trước khi viết lại lịch sử. Không nên áp dụng lệnh sửa lịch sử theo một công thức mà chưa biết nhánh đang được chia sẻ thế nào. Giá trị của commit nhỏ nằm ở khả năng hiểu, kiểm thử và xử lý sự cố, chứ không nằm ở việc đạt một số dòng lý tưởng.
Một thói quen dễ bắt đầu là dành vài phút cuối mỗi nhiệm vụ cho việc đọc diff và viết thông điệp. Khi có lỗi xuất hiện sau này, những ranh giới có ý nghĩa sẽ giúp tìm phạm vi cần kiểm tra nhanh hơn. Nhóm làm việc cũng có thể thảo luận từng quyết định mà không phải tách chúng khỏi nhiều thay đổi trang trí đi kèm.

Bình luận
Chưa có bình luận.
Đăng nhập để bình luận