Alternatives à Beamer

Ce en quoi Beamer excelle

Ça mérite d'être dit en premier, car ça détermine si changer aide vraiment. Beamer se configure vite, ne demande presque aucun temps d'ingénierie, et donne une page hébergée et un widget in-app depuis un seul éditeur. Si ta contrainte est que personne n'a le temps de construire quoi que ce soit, c'est un avantage réel que la plupart des alternatives ne battent pas.

Pourquoi les équipes cherchent une alternative

• Le widget ne ressemble pas à leur produit. Il est restylisable jusqu'à un certain point, et au-delà, c'est un combat permanent. Les équipes avec un système de design fort tombent sur ça en premier.
• Les entrées sont écrites à la main. Quelqu'un doit ouvrir l'éditeur après chaque version, et c'est l'étape qui saute lors d'une semaine chargée.
• Le changelog vit sur leur domaine plutôt que le tien, donc le trafic et la valeur de recherche vont là-bas et pas sur ton site.
• Ils veulent les entrées comme des données, à afficher dans leur propre interface ou à envoyer ailleurs, plutôt que comme un widget et une page.

Les alternatives, selon ce que tu veux vraiment

Si tu veux la même chose, avec un autre style

AnnounceKit s'en rapproche le plus : widget hébergé, page hébergée, un éditeur, et plus de contrôle sur qui voit quelle annonce. Changer est surtout une migration de contenu, pas un changement de façon de travailler.

Si tu veux aussi la boucle de feedback

Canny, Frill et Featurebase placent le changelog à côté du vote de fonctionnalités, d'une roadmap publique et d'une boîte de feedback. Choisis-en un si tu aurais de toute façon acheté ça séparément ; passe-les si tu veux juste des release notes, car tu paierais une suite pour n'en utiliser qu'un module.

Si tu veux que ça s'écrive tout seul

LaunchNotes et Released construisent le changelog à partir de ce que ton équipe produit déjà, Released étant particulièrement ancré sur les issues Jira. Changeloop le fait à partir des pull requests fusionnées : il rédige une entrée par fusion, filtre les montées de dépendances et les refactors, et garde le brouillon pour que tu le modifies avant de publier quoi que ce soit.

Si tu veux que ça fasse partie de ton produit

C'est la seule chose que Beamer ne peut structurellement pas faire, et la raison d'être de notre produit. Changeloop publie sur un flux JSON public avec CORS ouvert à toute origine, donc ton changelog est rendu par tes propres composants sur ton propre domaine, en une dizaine de lignes. Le widget et la page hébergée sont là comme solutions de repli, pas comme le produit lui-même.

Si tu veux juste un fichier dans le dépôt

git-cliff construit un CHANGELOG.md à partir des conventional commits en CI. Gratuit, rien à héberger, et la bonne réponse pour beaucoup de projets open source qui n'ont jamais eu besoin d'un widget.

Quand ne pas changer

Si le widget fonctionne, que personne ne se plaint du style, et que quelqu'un écrit les entrées avec constance, changer te coûte une migration et t'apporte très peu. Les raisons les plus solides de changer sont structurelles : tu veux le changelog sur ton propre domaine, ou tu veux qu'il soit généré depuis ton dépôt plutôt qu'à la main. Aucun des deux ne se résout en échangeant un widget hébergé contre un autre.

Questions fréquentes

Pouvons-nous récupérer nos entrées existantes ?

Demande à l'outil vers lequel tu migres ce qu'il importera, et à Beamer ce qu'il exportera, avant de te décider. C'est la partie d'une migration qui transforme une matinée en deux semaines.

Perdons-nous le widget in-app en passant à un flux ?

Non. Changeloop propose aussi un widget, en deux lignes de HTML, et il se rend dans un shadow root, donc il n'hérite ni ne fuit dans tes styles. La différence, c'est que le widget est la solution de repli, pas la seule option : les mêmes entrées sont sur un flux JSON que tu peux rendre toi-même.

Y a-t-il une option gratuite ?

Changeloop est gratuit pour un dépôt, flux et widget inclus, sans carte. git-cliff est gratuit et open source si un fichier dans le dépôt te suffit. Plusieurs outils hébergés ont des paliers gratuits ; vérifie les conditions actuelles sur leurs propres pages plutôt que de te fier à un tableau comparatif, celui-ci inclus.

Pour aller plus loin : Bonnes pratiques des release notes qui comptent, quel que soit l'outil sur lequel tu finis.