In cosa è bravo Beamer
Vale la pena dirlo per primo, perché decide se cambiare aiuti davvero. Beamer si configura in fretta, richiede quasi nessun tempo di sviluppo, e dà una pagina ospitata e un widget in-app da un solo editor. Se il tuo vincolo è che nessuno ha tempo di costruire qualcosa, è un vantaggio reale che la maggior parte delle alternative non batte.
Perché i team cercano un'alternativa
- Il widget non assomiglia al loro prodotto. Si può ristilizzare fino a un certo punto, e oltre quel punto è una lotta continua. I team con un forte design system ci sbattono contro per primi.
- Le voci si scrivono a mano. Qualcuno deve aprire l'editor dopo ogni rilascio, ed è il passaggio che salta in una settimana impegnativa.
- A meno di pagare l'opzione con dominio personalizzato, il changelog vive sul dominio di Beamer e non sul tuo, quindi il traffico e il valore SEO vanno lì e non al tuo sito.
- Vogliono le voci come dati, da renderizzare nella propria interfaccia o inviare altrove, invece che come widget e pagina.
Arriva la modalità scura
Attivala nelle Impostazioni o lascia che segua il tema di sistema.
Le alternative, in base a cosa vuoi davvero
Se vuoi la stessa cosa, con un altro stile
AnnounceKit è la cosa più simile: widget ospitato, pagina ospitata, un editor e più controllo su chi vede quale annuncio. Cambiare è soprattutto una migrazione di contenuti, non un cambiamento nel modo di lavorare.
Se vuoi anche il ciclo di feedback
Canny, Frill e Featurebase mettono il changelog accanto alla votazione delle funzioni, una roadmap pubblica e una casella di feedback. Scegline uno se avresti comunque comprato quelle cose separatamente; saltali se vuoi solo release notes, perché pagheresti una suite per usarne un modulo.
Se vuoi che si scriva da solo
LaunchNotes e Released costruiscono il changelog da ciò che il tuo team produce già, Released ancorato soprattutto alle issue Jira. Changeloop lo fa dalle pull request unite: redige una voce per ogni unione, filtra aggiornamenti di dipendenze e refactor, e trattiene la bozza perché tu la modifichi prima di pubblicare qualcosa.
Se vuoi che faccia parte del tuo prodotto
Questa è l'unica cosa che Beamer non può fare strutturalmente, ed è il motivo per cui esiste il nostro prodotto. Changeloop pubblica su un feed JSON pubblico con CORS aperto a qualsiasi origine, quindi il tuo changelog viene renderizzato dai tuoi componenti sul tuo dominio, in una decina di righe. Il widget e la pagina ospitata ci sono come alternative, non come il prodotto stesso.
Se vuoi solo un file nel repository
git-cliff costruisce un CHANGELOG.md dai conventional commit nella CI. Gratis, niente di ospitato, e la risposta giusta per molti progetti open source che non hanno mai avuto bisogno di un widget.
Beamer vs AnnounceKit
Sono entrambi widget ospitati con un editor e una pagina autonoma, quindi la scelta dipende soprattutto da cosa è incluso. AnnounceKit dà più peso a decidere chi vede quale annuncio. Beamer aggiunge più strumenti di coinvolgimento attorno al widget, come notifiche push e sondaggi NPS. Nessuno dei due scrive le voci a partire dalle tue pull request unite, e in entrambi le voci vivono nel loro editor e non nel tuo repository.
Quando non cambiare
Se il widget funziona, nessuno si lamenta dello stile e qualcuno scrive le voci con costanza, cambiare ti costa una migrazione e ti porta molto poco. I motivi più forti per cambiare sono strutturali: vuoi il changelog sul tuo dominio, oppure vuoi che venga generato dal tuo repository invece che a mano. Nessuno dei due si risolve scambiando un widget ospitato con un altro.
Domande frequenti
Possiamo portare le nostre voci esistenti?
Chiedi allo strumento a cui passi cosa importerà, e a Beamer cosa esporterà, prima di deciderti. È questa la parte di una migrazione che trasforma una mattina in due settimane.
Perdiamo il widget in-app se passiamo a un feed?
No. Changeloop offre anche un widget, in due righe di HTML, e renderizza in uno shadow root, quindi non eredita i tuoi stili né vi si infiltra. La differenza è che il widget è l'alternativa, non l'unica opzione: le stesse voci sono su un feed JSON che puoi renderizzare tu.
C'è un'opzione gratuita?
Changeloop è gratis per un repository, con feed e widget inclusi, senza carta. git-cliff è gratis e open source se un file nel repository è tutto ciò che ti serve. Diversi strumenti ospitati hanno livelli gratuiti; controlla le condizioni attuali sulle loro pagine invece di fidarti di una tabella comparativa, questa inclusa.
Per continuare a leggere: Buone pratiche per le release notes che meritano; Come costruire una pagina di changelog che si segue e i 13 strumenti di changelog a confronto.
Prova quella che dà priorità al feed
Redatta dalle tue pull request unite, trattenuta per la revisione, e pubblicata su un feed JSON che renderizzi dentro il tuo prodotto. Gratis per un repository, nessuna carta.
Inizia gratis