Alternatieven voor Beamer

Waar Beamer goed in is

Dit is het vermelden waard vooraan, want het bepaalt of overstappen echt helpt. Beamer is snel ingesteld, kost bijna geen engineeringtijd, en geeft een gehoste pagina en een in-app widget vanuit één editor. Als je beperking is dat niemand tijd heeft om iets te bouwen, is dat een echt voordeel dat de meeste alternatieven niet overtreffen.

Waarom teams naar een alternatief zoeken

• De widget lijkt niet op hun product. Het is tot op zekere hoogte te herstylen, en daarna is het een blijvend gevecht. Teams met een sterk designsysteem lopen hier het eerst tegenaan.
• Items worden met de hand geschreven. Iemand moet na elk release de editor openen, en dat is de stap die overgeslagen wordt in een drukke week.
• De changelog leeft op hun domein in plaats van het jouwe, dus het verkeer en de zoekwaarde gaan daarheen en niet naar jouw site.
• Ze willen de items als data, om te renderen in hun eigen interface of ergens anders naartoe te sturen, in plaats van als widget en pagina.

De alternatieven, op basis van wat je echt wilt

Als je hetzelfde wilt, met een andere stijl

AnnounceKit komt het dichtst in de buurt: gehoste widget, gehoste pagina, een editor, en meer controle over wie welke aankondiging ziet. Overstappen is vooral een contentmigratie, geen verandering in hoe je werkt.

Als je ook de feedbacklus wilt

Canny, Frill en Featurebase zetten de changelog naast functiestemming, een publieke roadmap en een feedback-inbox. Kies er een als je dat toch al apart zou kopen; sla ze over als je alleen release notes wilt, want dan betaal je een suite om er één module van te gebruiken.

Als je wilt dat het zichzelf schrijft

LaunchNotes en Released bouwen de changelog op basis van wat je team al produceert, waarbij Released vooral is verankerd aan Jira-issues. Changeloop doet het vanuit samengevoegde pull requests: het stelt per merge een item op, filtert dependency-updates en refactors eruit, en bewaart het concept zodat je het kunt bewerken voordat er iets wordt gepubliceerd.

Als je wilt dat het deel uitmaakt van je product

Dit is het enige wat Beamer structureel niet kan, en de reden waarom ons product bestaat. Changeloop publiceert naar een publieke JSON-feed met CORS open voor elke oorsprong, dus je changelog wordt gerenderd door je eigen componenten op je eigen domein, in ongeveer tien regels. De widget en de gehoste pagina zijn er als terugvaloptie, niet als het product zelf.

Als je alleen een bestand in de repository wilt

git-cliff bouwt een CHANGELOG.md op basis van conventional commits in de CI. Gratis, niets te hosten, en het juiste antwoord voor veel open-sourceprojecten die nooit een widget nodig hadden.

Wanneer niet overstappen

Als de widget werkt, niemand klaagt over de stijl, en iemand consistent de items schrijft, kost overstappen je een migratie en levert het je heel weinig op. De sterkste redenen om over te stappen zijn structureel: je wilt de changelog op je eigen domein, of je wilt dat hij vanuit je repository wordt gegenereerd in plaats van met de hand. Geen van beide wordt opgelost door het ene gehoste widget voor het andere te ruilen.

Veelgestelde vragen

Kunnen we onze bestaande items meenemen?

Vraag de tool waarnaar je overstapt wat die zal importeren, en Beamer wat het zal exporteren, voordat je een besluit neemt. Dit is het onderdeel van een migratie dat van een ochtend twee weken maakt.

Verliezen we de in-app widget als we naar een feed overstappen?

Nee. Changeloop biedt ook een widget, in twee regels HTML, en die rendert in een shadow root, dus hij neemt je stijlen niet over en lekt er ook niet in. Het verschil is dat de widget de terugvaloptie is, niet de enige optie: dezelfde items staan op een JSON-feed die je zelf kunt renderen.

Is er een gratis optie?

Changeloop is gratis voor één repository, met feed en widget inbegrepen, geen kaart. git-cliff is gratis en open source als een bestand in de repository alles is wat je nodig hebt. Meerdere gehoste tools hebben gratis niveaus; controleer de actuele voorwaarden op hun eigen pagina's in plaats van te vertrouwen op een vergelijkingstabel, deze inbegrepen.

Verder lezen: Beste practices voor release notes die het waard zijn, welke tool je ook kiest.