Альтернативы Beamer

В чём хорош Beamer

Стоит сказать в первую очередь, потому что это определяет, поможет ли переход. Beamer быстро настраивается, требует почти никакого времени инженеров и даёт размещённую страницу и виджет внутри приложения из одного редактора. Если ваше ограничение в том, что ни у кого нет времени что-то строить, это реальное преимущество, и большинство альтернатив его не превосходят.

Почему команды ищут альтернативу

• Виджет не выглядит как их продукт. Он перестилизуем до определённого момента, а за этим моментом вы боретесь с ним. Команды с сильной дизайн-системой обычно сталкиваются с этим первыми.
• Записи пишутся вручную. Кому-то нужно открывать редактор после каждого релиза, и это шаг, который пропускают в загруженную неделю.
• Changelog живёт на их домене, а не на вашем, так что трафик и ценность поиска идут туда, а не на ваш сайт.
• Они хотят записи как данные, чтобы рендерить в собственном интерфейсе или отправлять куда-то ещё, а не как виджет и страницу.

Альтернативы, по тому, чего вы на самом деле хотите

Если вы хотите то же самое, но с другим стилем

AnnounceKit — ближайший аналог: размещённый виджет, размещённая страница, редактор и больше контроля над тем, кто видит какое объявление. Переход — это в основном миграция контента, а не изменение способа работы.

Если вам нужен ещё и цикл обратной связи

Canny, Frill и Featurebase размещают changelog рядом с голосованием за функции, публичным roadmap и папкой обратной связи. Выберите одну из них, если вы всё равно собирались покупать это отдельно; пропустите, если вам нужны только релиз-ноты, потому что вы заплатите за пакет ради одного модуля.

Если вы хотите, чтобы оно писало себя само

LaunchNotes и Released оба строят changelog из того, что уже производит ваша команда, Released в частности опирается на issue Jira. Changeloop делает это из объединённых pull request'ов: составляет запись на каждое объединение, отфильтровывает обновления зависимостей и рефакторинг, и удерживает черновик для вашего редактирования перед публикацией.

Если вы хотите, чтобы это было частью вашего продукта

Это то, что Beamer структурно не может сделать, и причина, по которой существует наш собственный продукт. Changeloop публикует в публичный JSON-фид с открытым CORS для любого источника, так что ваш changelog рендерится вашими собственными компонентами на вашем собственном домене примерно в десяти строках. Виджет и размещённая страница там как резервные варианты, а не как продукт.

Если вам нужен просто файл в репозитории

git-cliff строит CHANGELOG.md из conventional commits в CI. Бесплатно, ничего не размещено, и правильный ответ для многих open-source проектов, которым никогда не был нужен виджет.

Когда не стоит переходить

Если виджет работает, никто не жалуется на стиль, и кто-то надёжно пишет записи, переход обойдётся вам в миграцию и даст очень мало. Самые сильные причины для переезда структурны: вы хотите changelog на своём собственном домене, или хотите, чтобы он производился из вашего репозитория, а не вручную. Ни одна из них не решается заменой одного размещённого виджета на другой.

Частые вопросы

Можем ли мы перенести наши существующие записи?

Спросите у инструмента, на который вы переходите, что он импортирует, и спросите у Beamer, что он экспортирует, прежде чем брать на себя обязательства. Это та часть миграции, которая превращает утро в две недели.

Теряем ли мы виджет в приложении, если переходим на фид?

Нет. Changeloop тоже поставляет виджет, в двух строках HTML, и он рендерится в shadow root, так что не наследует ваши стили и не влияет на них. Разница в том, что виджет — резервный вариант, а не единственный: те же записи находятся в JSON-фиде, который вы можете рендерить сами.

Есть ли бесплатный вариант?

Changeloop бесплатен для одного репозитория с включённым фидом и виджетом, без карты. git-cliff бесплатен и с открытым исходным кодом, если файл в репозитории — это всё, что вам нужно. У нескольких размещённых инструментов есть бесплатные уровни; проверьте текущие условия на их собственных страницах, а не доверяйте сравнительной таблице, включая эту.

Дополнительное чтение: лучшие практики релиз-нот, которые стоит сохранить, каким бы инструментом вы ни закончили пользоваться.