Mesclou no GitHub, a nota de versão está escrita.
A cada merge na branch principal, a Julia lê o pull request e escreve a nota em linguagem de usuário — ou deixa de fora, se for só ajuste interno. Fica tudo em rascunho até você publicar.
14 dias de teste · Sem cartão · Depois, plano gratuito
Julia, Marketing: “O que os merges desta semana deixaram no changelog?”
Dos 9 pull requests mesclados, 3 mudam algo que o usuário vê: exportação em CSV, filtro por data e a correção do login. Estão num rascunho só, em português e em inglês. Publico? Publicar a versão 2.4.0 no changelog. Publicado. Os outros 6 eram ajustes internos e ficaram de fora.
Studio Bravo é uma empresa de demonstração. Dados inventados.
As notas de versão, antes e depois
A nota de versão fica para depois — e o depois nunca chega.
O rascunho nasce no momento do merge, enquanto a mudança ainda está fresca.
O changelog vira uma lista de commits que só o time entende.
A agente escreve o que mudou para o usuário, sem nome de arquivo nem jargão interno.
Refatoração e atualização de dependência enchem a lista.
O que o usuário não percebe fica de fora do changelog.
Uma nota mal escrita vai ao ar sem ninguém revisar.
Tudo fica em rascunho. Publicar é um passo seu, separado.
Como funciona
Do merge à nota publicada — a parte chata é automática, a decisão continua com você.
1 · Conexão
Ligue o GitHub e escolha quem escreve
Conecte o repositório pelo app do GitHub nas integrações e inscreva a agente de marketing no evento de pull request mesclado. Só os merges na branch principal contam: o que entra numa branch de funcionalidade ainda não saiu.
- App do GitHub nas integrações
- A agente que você escolher responde ao evento
- Só merges na branch principal
2 · Triagem
A agente decide se o usuário percebe
Título, descrição, commits e arquivos alterados chegam junto com o evento. Funcionalidade nova, melhoria visível ou correção que alguém notou vira entrada; refatoração, dependência e CI ficam de fora.
- Julgado do ponto de vista do usuário
- Na dúvida, fica de fora
- Merges do mesmo assunto vão para o mesmo rascunho
3 · Rascunho
Escrito para quem usa, nos seus idiomas
Um título curto e poucas linhas sobre o que mudou, numa tradução para cada idioma em que você publica. Você edita, coloca etiquetas e o número da versão.
- Uma tradução por idioma
- Etiquetas e número de versão
- Sempre salvo como rascunho
4 · Publicação
No ar quando você disser
Publique na hora ou marque uma data. O changelog entra no seu site ou app por iframe, com busca, filtro por etiqueta e reações dos usuários.
- Publicação na hora ou com data marcada
- Busca e filtro por etiqueta
- Reações dos usuários em cada entrada
O changelog ligado ao produto inteiro
- Do roadmap ao changelogO que os usuários votaram no roadmap ganha a nota de versão na mesma base quando sai.
- Do pull request do agente à notaOs pull requests que o agente de desenvolvimento abre e você mescla entram no mesmo fluxo.
- Da nota à central de ajudaA funcionalidade anunciada ganha artigo e tutorial na wiki que o suporte usa para responder.
Módulos que você liga hoje
Lido do mesmo catálogo da loja de módulos: se está aqui, existe no produto.
- Roadmap, Changelog & Wikiplano gratuito disponível
- RoadmapRoadmap público do produto, com o que está sendo feito e o que vem depois.
- ChangelogChangelog de lançamentos para anunciar cada entrega aos seus usuários.
- WikiBase de conhecimento e documentação, interna ou pública.
A agente publica sozinha?
Não. Quando responde a um merge, ela só escreve o rascunho e para. Publicar é um passo separado, que espera o seu OK — no chat com ela ou na tela do changelog.
Funciona com GitLab ou Bitbucket?
Hoje, só com GitHub. Sem GitHub, você ainda escreve as notas na tela do changelog ou pede o rascunho para a agente no chat.
Já tenho um changelog em outro lugar. Começo do zero?
Não. Dá para importar as entradas antigas a partir de um CSV ou de texto.
Quanto custa?
O changelog público entra no plano gratuito do módulo de produto. Os planos pagos tiram o selo do BaseOS e somam a wiki.
Volte a ser o dono.Não o integrador.
Comece pela área que mais dói. Em 14 dias você sabe se o BaseOS fica — sem cartão, e com plano gratuito depois.
14 dias de teste · Sem cartão · Depois, plano gratuito