Nếu tôi sửa đổi readme của mình cho gói npm tôi duy trì, tôi có cần phải bump phiên bản trong package.json và thực hiện một lần xuất bản npm khác không? hoặc là có một cách khác để cập nhật readme mà không có một phiên bản bump.bump phiên bản khi cập nhật readme cho gói npm?
Tùy thuộc vào định nghĩa của bạn "cần", đây có thể là hai câu hỏi rất khác nhau:
[? Is it ok để công bố những thay đổi readme mà không cần chạm số phiên bản]
[Về mặt kỹ thuật, có thể xuất bản các thay đổi mà không cần tăng phiên bản]
Câu trả lời được chấp nhận (cập nhật qua npm publish --force, tức là không tăng bất kỳ phần nào của số phiên bản) là câu trả lời hay cho quý 2. Nhưng tôi muốn giải quyết Q1.
Không khuyến khích sử dụng npm publish --force. Thay vào đó, tác giả được khuyến khích sử dụng semantic versioning aka semver, quy định:
... định dạng phiên bản của X.Y.Z (Major.Minor.Patch). Sửa lỗi không ảnh hưởng đến việc tăng API phiên bản vá, tương thích ngược Bổ sung/thay đổi API tăng phiên bản phụ và ngược lại thay đổi API không tương thích tăng lên phiên bản chính.
Vì vậy, câu trả lời của tôi là: Mặc dù về mặt kỹ thuật là cách để xuất bản thay đổi mà không gặp phải lỗi phiên bản, bạn không nên làm điều đó. Đối với các chỉnh sửa nhỏ không ảnh hưởng đến API của gói, bạn nên sử dụng phiên bản "vá", ví dụ: từ 1.2.0 đến 1.2.1.
npm publish --force sẽ ghi đè lên nếu số phiên bản đã tồn tại trong sổ đăng ký.
Bạn có thể không xuất bản:
npm unpublish [@<scope>/]<name>[@<version>]
, nhưng nó là không còn có thể publish --force, vì nó đã bị phản đối. Điều duy nhất bạn có thể làm ngoài việc này là xuất bản một phiên bản mới. Nó được thảo luận chi tiết tại đây: http://blog.npmjs.org/post/77758351673/no-more-npm-publish-f
Trong trường hợp không rõ ràng, tài liệu npm cho [unpublish] (https://docs.npmjs.com/cli/unpublish) nêu rõ rằng "Ngay cả khi phiên bản gói chưa được xuất bản, kết hợp tên và phiên bản cụ thể đó không bao giờ có thể được tái sử dụng. Để xuất bản lại gói, phải sử dụng số phiên bản mới. ". Điều này về cơ bản có nghĩa là việc hủy xuất bản và tái xuất bản không phải là một công việc xung quanh trong việc cập nhật tài liệu mà không có một vết sưng vá. – shennan
Đối với những người khác ở đây và nghĩ rằng họ đã làm đúng. Vâng, bạn đã làm đúng; Kiểm tra trang npm của bạn sau 5-10 phút.
Ok, đó là loại những gì tôi đã tìm. Tôi chỉ nên chạm nhẹ vào những thay đổi của readme. – chovy
Đồng ý. Đây chắc chắn là câu trả lời đúng cho Q1. – srquinn
lực lượng hiện không được chấp nhận –