Khi chuẩn bị ghi chú phát hành, bạn có thể bắt đầu bằng danh sách commit từ bản trước đến bản mới. Nếu repo có nhiều tác giả, git shortlog giúp gom tiêu đề commit theo người viết. Dùng danh sách đó để tìm các thay đổi cần đọc kỹ trước khi mô tả tính năng hoặc sửa lỗi cho người dùng.
Chọn hai mốc trước khi nhóm
Trong ví dụ dưới đây, thay v1.4.0 và v1.5.0 bằng hai tag có thật trong repo của bạn. Phạm vi hai chấm chọn các commit đi tới được từ mốc bên phải nhưng không đi tới được từ mốc bên trái. Đây là phép chọn theo lịch sử Git. Nếu hai tag nằm trên các nhánh đã tách, kết quả có thể khác kỳ vọng về thứ tự phát hành. Kiểm tra quan hệ tổ tiên nếu quy trình của đội giả định bản mới chứa bản cũ.
git log --oneline v1.4.0..v1.5.0
git shortlog v1.4.0..v1.5.0
git shortlog -sn v1.4.0..v1.5.0
Lệnh đầu cho bạn từng commit và mã rút gọn để kiểm tra phạm vi. Lệnh thứ hai nhóm tiêu đề theo tác giả. Cặp tùy chọn -sn rút kết quả về số commit theo tác giả và sắp theo số lượng. Khi đọc kết quả ở script chạy không có terminal, hãy giữ phạm vi hoặc chỉ định HEAD rõ ràng để Git biết cần đọc lịch sử repo.
Đọc số đếm theo quy trình merge
Một pull request gộp bằng squash có thể xuất hiện dưới dạng một commit trong nhánh phát hành. Nếu repo giữ merge commit, quyết định có muốn xem chúng hay không. Thêm –no-merges vào cả lệnh log và shortlog nếu mục tiêu là kiểm tra các commit không phải merge. Giữ cùng bộ lọc ở hai đầu để dễ giải thích vì sao danh sách và thống kê khớp hoặc lệch. Nếu một người xuất hiện dưới hai tên, xem lại danh tính tác giả và quy tắc mailmap của repo trước khi dùng kết quả làm danh sách ghi công.
Kiểm tra ghi chú trước khi gửi
Đối chiếu vài commit ở đầu và cuối phạm vi với trang phát hành hoặc pull request tương ứng. Nếu đầu ra trống, xác nhận thứ tự hai mốc và kiểm tra chúng có trỏ đến cùng commit không. Nếu repo là shallow clone, lấy đủ lịch sử để phép so sánh có các mốc cần thiết. Sau khi xác nhận phạm vi, đọc diff hoặc mô tả pull request của những thay đổi quan trọng để diễn đạt ảnh hưởng đến người dùng. Số lượng commit mô tả cách lịch sử được ghi lại và không đo khối lượng đóng góp.
Nếu ghi chú chỉ dành cho một thành phần, thêm đường dẫn sau dấu phân cách — và dùng cùng đường dẫn khi đối chiếu với git log. Ghi lại giới hạn này bên cạnh bản nháp để đồng đội biết vì sao thay đổi ở thành phần khác không xuất hiện.

