Se modifico il mio readme per un pacchetto npm che mantengo, devo eseguire il bump della versione in package.json e pubblicare un altro npm? o c'è un altro modo per aggiornare il readme senza un bump di versione.versione bump durante l'aggiornamento di readme per il pacchetto npm?
A seconda della definizione di "bisogno di", questo potrebbe essere due questioni molto diverse:
[? E 'ok per pubblicare le modifiche readme senza urtare il numero di versione]
[E 'tecnicamente possibile pubblicare le modifiche senza incrementare la versione]
La risposta accettata (l'aggiornamento tramite npm publish --force, ovvero senza incrementare alcuna parte del numero di versione) è una buona risposta a Q2. Ma voglio affrontare la Q1.
L'utilizzo di npm publish --force è sconsigliato. Invece, gli autori sono incoraggiati ad utilizzare semantic versioning aka semver, che prescrive:
... formato versione di X.Y.Z (Major.Minor.Patch). Correzioni di bug non che incidono sull'API incrementare la versione della patch, le aggiunte o le modifiche all'API all'indietro e le modifiche incrementano la versione secondaria, mentre le modifiche dell'API incompatibili con l' incrementano la versione principale.
Quindi la mia risposta è: Mentre v'è tecnicamente un modo per pubblicare modifiche senza una versione urto, non si dovrebbe farlo. Per le modifiche minori che non influiscono sull'API del pacchetto, dovresti eseguire il bump della versione "patch", ad es. da 1.2.0 a 1.2.1.
npm publish --force sovrascriverà se il numero di versione esiste già nel registro.
È possibile annullare la pubblicazione:
npm unpublish [@<scope>/]<name>[@<version>]
, ma non è più possibile publish --force, come è stato deprecato. L'unica cosa che puoi fare oltre a questo è pubblicare una nuova versione secondaria. È discusso in dettaglio qui: http://blog.npmjs.org/post/77758351673/no-more-npm-publish-f
Nel caso non fosse chiaro, la documentazione di npm per [unpublish] (https://docs.npmjs.com/cli/unpublish) afferma che "Anche se una versione del pacchetto non è pubblicata, quella combinazione di nome e versione specifica non può mai riutilizzare Per poter pubblicare nuovamente il pacchetto, è necessario utilizzare un nuovo numero di versione. ". Ciò significa in sostanza che la pubblicazione e la ripubblicazione non sono una soluzione per l'aggiornamento della documentazione senza un patch bump. – shennan
Per gli altri che atterrano qui e pensano di aver fatto bene. Sì, l'hai fatto bene; Controlla la tua pagina npm in 5-10 minuti.
Ok, questo è un po 'quello che ho capito. Dovrei limitarmi a leggere le modifiche al readme. – chovy
concordato. Questa è sicuramente la risposta corretta al primo trimestre. – srquinn
la forza è ora deprecata –