Guida alle Patch Notes: cosa sono e perché andrebbero sempre lette

jabba

Diciamocelo. Nessuno legge le patch notes. Ormai forse neanche chi le scrive, visto che probabilmente usa ChatGPT per farlo. Tipo il cugino informatico dei termini&condizioni, che stanno lì, tutti le accettano ma nessuno le legge

Eppure sono importanti: sono documenti rilasciati dagli sviluppatori per accompagnare gli aggiornamenti di un software. Servono a spiegare in modo trasparente le modifiche introdotte, siano esse correzioni di bug, miglioramenti, nuove funzionalità o aggiornamenti di sicurezza. Per noi che gestiamo siti web in ambito professionale, leggere attentamente le patch notes è fondamentale.

Perché è Importante Leggerle

Capire cosa cambia
Le patch notes ti aiutano a capire quali aspetti di Joomla sono stati modificati. Per esempio sono molto utili per capire se un aggiornamento è urgente o meno, se possiamo aspettare (per capire dai social e da GitHub se ci sono stati problemi) o se è meglio installare tutto al Day1
Prepararsi a testare
Dopo un aggiornamento, è essenziale testare i siti per verificare che tutto funzioni come previsto. Le patch notes ti guidano su quali aree controllare: se in un aggiornamento leggi che è stato cambiato il modo di visualizzare i Tour Guidati e tu gestisci un sito che fa uso massiccio di questa features allora è sicuramente il caso di controllare che tutto vada per il verso giusto.
Questioni di sicurezza
Non leggere le patch notes può farti perdere aggiornamenti di sicurezza fondamentali, esponendo i siti a vulnerabilità.

Bonus: Conoscere le differenze tra aggiornamenti major e minor

Major update (ad esempio, Joomla 5.x): Introducono cambiamenti significativi, come nuove funzionalità e a volte modifiche che richiedono adattamenti importanti.
Minor update (ad esempio, Joomla 5.2.x): Si concentrano su correzioni di bug e miglioramenti incrementali, meno invasivi ma ugualmente importanti.

Struttura Tipica delle Patch Notes

1. Introduzione

--

Spiega il motivo dell’aggiornamento e offre un riepilogo generale delle modifiche introdotte. Se si ha fretta a volte basta leggere questo paragrafo per capire quanto è importante o meno applicare la patch.
Esempio: "Joomla 5.2.2 è una release di sicurezza e manutenzione che risolve X vulnerabilità e introduce miglioramenti nelle performance."

2. Lista delle correzioni (fix)

--

Una sezione chiave che elenca i bug risolti con link a GitHub.

Cos’è GitHub?
GitHub è una piattaforma di versionamento del codice dove gli sviluppatori collaborano e condividono i progetti. I link nelle patch notes permettono di esaminare il codice delle modifiche, offrendo trasparenza e approfondimenti tecnici.

3. Opzionale: Aggiornamenti di sicurezza

Questa sezione opzionale dove si fa focus sugli aggiornamenti di sicurezza. Ovviamente non si va nel dettaglio (non si vuole dare ai malintenzionati del materiale di partenza su cui lavorare) ma viene spiegato cosa è stato trovato e come è stato risolto.

4. Nuove funzionalità

Se presenti, vengono descritte brevemente le novità introdotte. È importante sapere se richiedono configurazioni aggiuntive o adattamenti al sito. Come dicevamo questa parte è presente quasi esclusviamente nelle patch notes delle major release (5.2 -> 5.3 ecc...)

Morale della favola? Facciamo il fioretto di Natale e sforziamoci a leggere un po' di più le patch notes, potrebbe aiutare molto noi utilizzatori a scovare eventuali bug e segnalarli a chi di dovere (su GitHub!).

Buona lettura!

webman

Hai perfettamente ragione, anch'io la prima cosa da un rilascio (che si tratta di Joomla o una qualsiasi estensione), do un occhiata al changelog, che è molto utile.

Gioacchino

@Ricsca il fatto che non leggi i post lunghi non mi sembra un modo per imparare