OK – mi sono sempre chiesto questo, quindi chiederò…
Ricevo email dalla nostra istanza Discourse che mi informano che è disponibile una “Nuova versione”.
C’è un link “Vedi cosa c’è di nuovo nelle note di rilascio…”
Ma quando clicco sul link, non c’è alcun accenno a quella nuova versione e alle sue note di rilascio.
Guarda qui: diceva che la nuova versione è la 2.5.2, ma ora guarda lo schermo a cui punta il link: vedi qualche menzione delle note di rilascio della 2.5.2?
Quindi, invece di aiutarmi, il link mi ha frustrato.
Grazie, ma solo per assicurarci di essere allineati…
Il link dice che mi porta alle note di rilascio della versione 2.5.2, ma non è così. Non si fa alcun riferimento alle note di rilascio della versione 2.5.2 in quel link o in quella pagina.
La stessa cosa è accaduta nell’ultimo annuncio.
Di solito non pubblichiamo note di rilascio per gli aggiornamenti stabili, poiché si tratta di modifiche estremamente minori, come solo correzioni di bug essenziali portate indietro, ecc. È possibile che tu possa estrarre le modifiche stabili da GitHub tramite un link speciale; forse @jomaxro ha un’idea.
In genere consigliamo di rimanere su tests-passed: tutti i nostri clienti e i servizi di hosting sono su tests-passed.
Jeff ha ragione: non scrivo note di rilascio per le versioni stabili. L’email che hai ricevuto è un messaggio standard condiviso da tutte le istanze di Discourse. Non sa su quale ramo ti trovi.
Le versioni puntuali stabili includono solo correzioni critiche di bug e patch di sicurezza. A differenza delle nostre normali release, che contengono centinaia di modifiche, le versioni puntuali stabili ne hanno generalmente meno di 10, spesso molto meno.
Puoi visualizzare tutte le modifiche su https://github.com/discourse/discourse/commits/stable. Cerca “Version bump to v{current version}” e “Version bump to v{previous version}”. Tutto ciò che sta tra queste due è l’elenco delle modifiche. Nel caso della v2.5.2 ci sono 7 modifiche: 3 di sicurezza, 2 follow-up alle modifiche di sicurezza e 2 correzioni critiche delle prestazioni.
Capito. La tua motivazione per non redigere note di rilascio per le versioni stabili ha un certo senso. Il mio unico punto è che MOLTI di noi ricevono notifiche via email e, nella MAGGIOR parte dei casi, il collegamento alle Note di Rilascio non contiene nulla. Un’opzione sarebbe modificare il modello per impostare meglio le aspettative, invece di essere ingannato e, solitamente, cliccare per scoprire che non c’è nulla di correlato all’email appena ricevuta.
Se fosse il nostro prodotto, impiegherei 10 minuti per creare una nota di rilascio per ogni versione.
Basterebbe dire: “Questa è una versione minore. Basso rischio. Principalmente correzioni di bug. Tuttavia, abbiamo modificato il modo in cui viene gestito xxx, nel caso tu voglia essere informato su questo miglioramento o su un potenziale impatto.”
Propongo di aggiornare il modello standard dell’email per gli aggiornamenti di versione:
Sostituisci
"Scopri le novità nelle note di rilascio"
con
“Scava tra queste note di rilascio e cerca di capire cosa c’è in questa nuova versione, dato che non ci sono note di rilascio per questa versione”
Contesto
Oggi ho ricevuto un’altra email che annuncia la disponibilità della versione 2.7.1 e invita a consultare il link alle note di rilascio, che però non contiene alcuna nota per la 2.7.1. Il link dovrebbe essere utile o essere omesso.
abbiamo avuto alcune discussioni interne. Come immagino tu possa capire, non modificheremo il testo come hai proposto. Anche se consigliamo ancora che i siti rimangano su tests-passed, come impostazione predefinita, creeremo note di rilascio per le versioni stabili d’ora in poi. Tieni presente che le note non includeranno lo stesso livello di dettaglio delle note di rilascio normali, poiché gli aggiornamenti stabili includono solo correzioni critiche di bug e patch di sicurezza.
Molto bene. Mi scuso per il tono sarcastico, ma quando ricevo l’avviso di una nuova versione, voglio immediatamente cliccare sul link per capire come questa release possa influenzare i miei utenti e quanto sia prioritario aggiornarsi, ecc. Tuttavia, rimango sempre frustrato perché il link non fa questo e, nella maggior parte dei casi, non ci sono mai documenti con lo stesso numero di versione citati nell’aggiornamento. Ora devo quindi decidere quanto tempo dedicare alla ricerca di documenti specifici per quella release. Ovviamente, un documento con la dicitura “beta” o un numero di versione precedente potrebbe essere significativamente diverso dalla release finale, quindi quei documenti non mi sono utili.
Per future referenze, il changelog effettivo per un aggiornamento stabile maggiore, come 2.5.0, è la somma di tutte le versioni beta che iniziano con la versione: 2.5.0.beta[1,2,3,4,5,6,7]. Ci impegniamo a mantenere le versioni “beta” utilizzabili in ogni momento, e il nostro ramo “stable” è più focalizzato sulla mancanza di cambiamenti che sulla mancanza di bug.
Speriamo che le note di rilascio delle patch aiutino a chiarire la confusione.
