Có bất kỳ loại nguyên tắc hoặc phương pháp hay nhất nào về cách ghi chú phát hành phải được viết không? Tôi đoán tôi đang cố gắng tìm sự cân bằng hợp lý giữa việc đưa ra điểm mà không quá cụ thể. Ngoài ra, nhà phát triển có thường cung cấp ghi chú phát hành nhiều hơn cho nhóm QA so với ghi chú phát hành cho chế độ xem công khai không?Ghi chú phát hành nên được viết như thế nào?
ghi chú phát hành công cộng nên chứa ít nhất:
QA ghi chú phát hành nên chứa ít nhất:
Cân nhắc khán giả của bạn và cố gắng nghĩ những gì họ cần.
Một điều khác cần thêm là hỗ trợ mới hoặc không được hỗ trợ cho một số nền tảng nhất định. (Ví dụ, chúng tôi bỏ hỗ trợ cho Win3.1 và thêm Vista 64 bit).
Một số điểm bổ sung: - Xuất bản ở dạng văn bản thuần túy hoặc ít nhất là html . Đừng khiến họ khó xem. - Việc thêm ghi chú phát hành lên đầu ghi chú phát hành cũ là điều phổ biến. - Đôi khi tốt khi đề cập đến các lỗi đã biết chưa được giải quyết. –
Ngoài ra tốt đẹp. Tôi chắc chắn sẽ đi cho văn bản đơn giản. Nhưng nếu bạn có thể tạo ghi chú phát hành, không có lý do gì để không inlcude html, pdf, v.v. –
Nếu bạn có hệ thống theo dõi quản lý dự án/vấn đề, bạn chắc chắn sẽ sử dụng hệ thống đó để tạo ghi chú phát hành của mình. Trac và Redmine nói riêng là rất tốt.
điểm phát hành nên có một vài thuộc tính, IMO:
Nó thực sự phụ thuộc vào khán giả. Đối với người dùng kỹ thuật (ví dụ nhà phát triển sử dụng API của bạn), bạn có thể rất kỹ thuật. Ở đầu người dùng cuối cao cấp khác của ứng dụng bạn đã tạo có thể chỉ quan tâm đến các tính năng mới và thay đổi lớn.
Giữa những người dùng không có kỹ thuật cũng cần chi tiết, ví dụ như bộ phận hỗ trợ. Đối với những người bạn có thể đưa ra một mô tả chi tiết mà không có các chi tiết kỹ thuật ở mức độ thấp, ví dụ như "Sửa lỗi mà bản ghi không được lưu trong cơ sở dữ liệu."
Một phương pháp hay nhất với ghi chú phát hành theo ý kiến của tôi là tự động hóa. Nếu có một số phương pháp hay nhất cho hệ thống kiểm soát sửa đổi gửi tin nhắn (http://drupal.org/node/52287), bạn có thể tạo ghi chú phát hành bằng tập lệnh tự động (http://cvs.drupal.org/viewvc.py/drupal/contributions/tricks/cvs-release-notes/). Điều này sẽ tạo ra các ghi chú phát hành thực sự tốt đẹp: http://drupal.org/node/226165
Cộng tác viên chính của Ghi chú phát hành sẽ là nhóm phát triển của bạn. Đó là một thực hành tốt để cho phép các nhà phát triển và người thử nghiệm của bạn nắm bắt bất kỳ thông tin ghi chú phát hành nào liên quan đến công việc của bạnCác mục được liên kết với các thay đổi trong TFS.
Sau đó, bạn có thể sử dụng dự án nguồn mở như http://tfschangelog.codeplex.com để tạo ghi chú phát hành. Nó có phiên bản GUI và một phiên bản dòng lệnh giúp bạn dễ dàng lập lịch báo cáo ghi chú phát hành hàng đêm.
Câu hỏi hay nhưng không có một số chi tiết cụ thể, bạn sẽ không nhận được câu trả lời hữu ích. Gần như những gì bạn đang phát hành, làm thế nào và ai cũng sẽ giúp đỡ. –
bản sao có thể có của [Ghi chú phát hành, điều gì?] (Http://stackoverflow.com/questions/315628/release-notes-what-for) – lindelof