Il Changelog di Narraya: cosa cambia, come lo diciamo
Il changelog di Narraya raccoglie feature, improvement, fix e breaking change. Trasparenza pubblica, feed RSS, continuità per chi scrive a lungo.
Il lavoro che rende un software affidabile, nella maggior parte dei casi, è invisibile. Un bug risolto il giovedì notte non fa notizia; un'ottimizzazione che fa caricare una pagina in 300 millisecondi anziché 800 non compare nelle newsletter. Eppure sono esattamente questi gli interventi che, sommati, distinguono un prodotto maturo da uno raffazzonato. Il changelog esiste per rendere visibile quel lavoro — e per rispetto di chi usa Narraya tutti i giorni.
Cos'è un changelog
Il changelog è un elenco pubblico di tutti i cambiamenti rilasciati in Narraya, in ordine cronologico inverso. Lo trovi all'indirizzo /it/changelog. Ogni voce riporta la data di rilascio, il tipo di cambiamento, e una descrizione breve — abbastanza da capire se qualcosa ti riguarda, abbastanza corta da scorrersi in un minuto.
Non è un diario tecnico pensato per gli sviluppatori. È una comunicazione rivolta agli autori che usano Narraya: cosa è nuovo, cosa è stato migliorato, cosa è stato sistemato, cosa è cambiato nel modo in cui alcune funzioni si comportano.
I quattro tipi di voce
Ogni modifica nel changelog è etichettata. La classificazione, per chi ha fretta, permette di saltare a quello che interessa: chi cerca solo le novità salta i fix; chi è attento alla stabilità controlla soprattutto le correzioni.
| Tipo | Cosa significa | Esempio |
|---|---|---|
| Feature | Una funzionalità nuova, mai esistita prima | "Aggiunto il Kanban dei capitoli" |
| Improvement | Una funzione esistente che ora lavora meglio, più velocemente o in modo più chiaro | "L'export in PDF è ora circa tre volte più rapido" |
| Fix | Un bug corretto: qualcosa non funzionava come doveva e ora funziona | "Risolto un problema per cui le liste annidate perdevano l'indentazione nell'export DOCX" |
| Breaking | Un cambiamento che altera il comportamento di una funzione esistente. Sempre segnalato in evidenza | "La scheda personaggio ora richiede obbligatoriamente il campo Nome" |
I breaking sono i più rari — e anche i più delicati. Quando un cambiamento altera il modo in cui qualcosa si comportava, diamo comunicazione in anticipo: via mail agli utenti coinvolti, in evidenza nel changelog, e spesso con un periodo di "doppia compatibilità" in cui vecchio e nuovo convivono. Non vogliamo che tu apra Narraya un lunedì e scopra che un'abitudine su cui costruivi le tue sessioni è saltata senza preavviso.
Come leggere il changelog
Non serve leggerlo sempre intero. Per la maggior parte degli utenti, tre approcci funzionano bene, a seconda del momento:
- Scansione settimanale. Ogni lunedì mattina, due minuti: scorri le voci dell'ultima settimana, vedi se qualche novità ti riguarda. Diventa un'abitudine leggera.
- Consultazione occasionale. Quando un comportamento ti sembra cambiato, cerca nel changelog. Spesso la risposta è lì, con la data esatta e la spiegazione breve.
- Panoramica dopo le pause. Se torni a Narraya dopo un mese di viaggio o di blocco creativo, una lettura dell'ultimo mese del changelog ti riorienta meglio di qualsiasi newsletter.
Per non dover aprire il changelog a mano, c'è un feed RSS dedicato. Aggiungilo al tuo aggregatore preferito e riceverai soltanto gli aggiornamenti importanti — niente mail, niente notifiche push. Il link al feed è in fondo alla pagina del changelog. Un modo silenzioso di restare informati: Narraya ti rispetta anche nel come comunica.
Perché non mettere tutto nelle release note dentro Narraya
Una domanda legittima: perché un changelog pubblico, anziché un "avviso di novità" dentro l'applicazione? Per due motivi. Il primo è che molti non vogliono essere interrotti mentre scrivono da popup che celebrano nuove funzioni. Il momento della scrittura è sacro; le novità possono aspettare la prossima pausa caffè. Il secondo è che un changelog pubblico è consultabile anche da chi non è ancora utente di Narraya: chi sta valutando la piattaforma può vedere, in trasparenza, quanto ci lavoriamo e cosa stiamo facendo.
La continuità per chi scrive un romanzo lungo
C'è una cosa a cui teniamo particolarmente: la continuità. Se stai scrivendo un romanzo su Narraya da otto mesi, i cambiamenti che introduciamo non devono spaventarti. Per questo nel changelog sei in grado di vedere, ogni volta, l'elenco completo di cosa è stato toccato — e se qualcosa riguarda una funzione che usi, capire se il tuo flusso di lavoro resta uguale o se dovrai adattarlo.
Un buon changelog è, in un certo senso, un contratto di continuità tra chi fa il prodotto e chi ci vive dentro. Ti diciamo tutto. Ti spieghiamo cosa cambia. Ti avvisiamo in anticipo se qualcosa di importante si sposta. È il modo in cui un progetto piccolo, come il nostro, può guadagnarsi la fiducia che serve per accompagnare romanzi di anni. Non chiediamo fiducia cieca: la costruiamo voce per voce, nel changelog.
Consulta il changelog aggiornato quando vuoi. Iscriviti al feed RSS in fondo alla pagina se preferisci una lettura asincrona, silenziosa e rispettosa del tuo tempo.