Glossario · ThinkClouds

Versionamento semantico

Schema di numerazione MAGGIORE.MINORE.CORREZIONE in cui ogni parte dice che tipo di cambiamento contiene una nuova versione.

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.

Fonti

Serve aiuto?

Installiamo, configuriamo e colleghiamo il plugin al tuo sito, con i template Elementor già pronti.