Viết commit message để chính bạn của sáu tháng sau cảm ơn

Lịch sử Git là cuốn nhật ký của dự án. Một quy ước commit đơn giản giúp bạn tìm lỗi, viết changelog và review nhanh hơn.

“fix bug”, “update”, “wip” — nếu lịch sử Git của bạn trông như vậy, mỗi lần truy vết lỗi sẽ là một cuộc khảo cổ.

Cấu trúc ba phần

text
feat: thêm mục lục tự động cho bài viết

Mục lục được sinh từ các heading cấp 2 và 3 để người đọc
nhảy nhanh tới phần cần xem trên bài dài.

Refs: #12
  • Dòng tiêu đề: loại thay đổi + mô tả ngắn, dưới 72 ký tự.
  • Phần thân: giải thích vì sao, không phải làm gì — diff đã cho thấy làm gì.
  • Phần cuối: liên kết issue hoặc ghi chú breaking change.

Mỗi commit một ý

Commit nhỏ, đúng một ý giúp git revert an toàn và git bisect chính xác. Nếu tiêu đề cần chữ “và”, có lẽ nên tách thành hai commit.

Tách thay đổi theo từng phần trước khi commit
git add -p
git commit -m "fix: xử lý slug có dấu tiếng Việt"

Nhận bài tiếp theo qua email.

Một email mỗi tuần, chỉ khi có điều đáng đọc. Không spam.