Il versionamento semantico (Semantic Versioning, SemVer) è uno schema per numerare le versioni di un software in modo che il numero dica che tipo di cambiamento contiene. La specifica, scritta da Tom Preston-Werner, è pubblicata su semver.org; la versione 2.0.0 risale al 2013.
Le tre cifre
Un numero di versione ha la forma MAGGIORE.MINORE.CORREZIONE, per esempio 2.13.1. Si incrementa la correzione per una modifica che risolve un errore senza cambiare il comportamento previsto; la minore per una funzione nuova compatibile con le versioni precedenti; la maggiore per un cambiamento incompatibile, che richiede a chi usa il software di adattarsi. Quando aumenta una cifra, quelle alla sua destra tornano a zero. Si possono aggiungere etichette di anteprima, come 3.0.0-beta.1. Le versioni che cominciano con 0, come 0.31.0, indicano un software ancora in sviluppo iniziale, in cui tutto può cambiare.
Perché conta
Un numero di versione è una promessa. Chi vede passare un plugin da 1.3.0 a 1.3.1 si aspetta una correzione da installare senza pensieri; da 1.3 a 1.4 una novità da provare; da 1 a 2 un cambiamento da leggere prima. Quando la promessa non viene rispettata, per esempio una “correzione” che cambia il formato dei dati, gli aggiornamenti automatici rompono i siti. Anche il confronto fra versioni funziona solo se il formato è coerente: WordPress e PHP le confrontano cifra per cifra, per cui 1.10.0 è più recente di 1.9.0.
Nei plugin ThinkClouds
I plugin ThinkClouds usano numeri a tre cifre, e ThinkRepo rifiuta il caricamento di un pacchetto la cui intestazione non contiene una versione valida. Il numero compare nella scheda del catalogo accanto alla data di aggiornamento e all’impronta SHA-256, e il changelog elenca le modifiche versione per versione. ThinkWatch, negli audit, permette di annotare le versioni di ogni plugin prima e dopo l’aggiornamento, per collegare un eventuale problema alla versione che lo ha introdotto.