Engenharia
Changelogs como artefato de build: convenções, automação, pipelines.
Comece por aqui: Keep a Changelog explicado, com template de CHANGELOG.md, Dos conventional commits a um changelog, Automação de changelog: o que automatizar e o que não
-
O que é hotfix? Significado, hotfix vs patch e como lançar
Hotfix é uma correção urgente lançada fora do ciclo normal de releases. O que o termo significa, como difere de patch e bugfix e como lançar com segurança.
Engenharia7 min de leitura
-
Release candidate (RC): o que significa e como conduzir
Release candidate é a build que vira a versão final se os testes não acharem um bloqueio. Onde o RC fica após o beta, como versionar e critérios de saída.
Engenharia5 min de leitura
-
CHANGELOG.md: o que vai nele e como mantê-lo atualizado
Um CHANGELOG.md é o registro voltado ao leitor do que mudou em cada versão. As seções necessárias, um exemplo completo e o hábito que o mantém atualizado.
Engenharia6 min de leitura
-
Release notes do GitHub: gere e depois torne legíveis
O GitHub rascunha release notes dos pull requests integrados em um clique. O que ele traz, como o release.yml o molda e a edição que o torna legível.
Engenharia7 min de leitura
-
Processo de gerenciamento de releases para entregas rápidas
Um processo de gerenciamento de releases em sete passos, com responsável e critério de saída para cada um, mais as métricas DORA e um KPI extra para medir.
Engenharia8 min de leitura
-
Quem escreve o changelog, e quem deveria
Quem escreve o changelog? A autora do PR sabe o que mudou; a PM, por que importa. Nenhuma sozinha escreve uma entrada útil, e escolher uma o envelhece.
Engenharia5 min de leitura
-
Formatos de arquivo de changelog: JSON, YAML ou só Markdown
O formato de um arquivo de changelog decide se ele alimenta uma página e um widget, ou só é lido por alguém. Markdown, JSON e YAML têm custos distintos.
Engenharia6 min de leitura
-
Exigir entrada de changelog no GitHub Actions: workflow
Um check de changelog no GitHub Actions recusa o merge sem entrada, porque um passo que depende de memória falha num padrão previsível. E o que ele quebra.
Engenharia6 min de leitura
-
Git tags vs releases do GitHub vs changelog
Uma tag do git, um lançamento, uma entrada de changelog: três registros de um evento. Confundi-los faz o changelog se desviar. Como os três se encaixam.
Engenharia6 min de leitura
-
Changelogs em monorepo: um só, ou um por pacote?
Um monorepo pode ter um changelog para o repositório inteiro ou um por pacote, e escolher errado deixa o lançamento barulhento demais ou espalhado demais.
Engenharia6 min de leitura
-
Semantic versioning e changelog: o que cada salto significa
Semantic versioning diz quanto um lançamento pode doer antes de ler uma palavra do changelog. O que cada número promete, e o que uma entrada deve a ele.
Engenharia6 min de leitura
-
Página de changelog: como criar uma que as pessoas assinam
Uma página de changelog vale a pena quando as pessoas voltam a ela. Onde ela vive, o que cada entrada precisa, feeds e markup, e onde o widget se encaixa.
Engenharia7 min de leitura
-
Automação de changelog: o que automatizar e o que não
Automatize coleta, formatação e publicação. Não automatize seleção ou formulação. Onde a linha está e o que acontece cada vez que ela se move.
Engenharia7 min de leitura
-
Dos conventional commits a um changelog
Conventional commits tornam um changelog derivável. Não o tornam legível. O que a convenção entrega, onde ela para, e como você preenche a lacuna.
Engenharia6 min de leitura
-
Keep a Changelog explicado, com template de CHANGELOG.md
A especificação é uma página e leva dez minutos para ler. Implementá-la é onde as equipes se desviam. O que ela diz, o que deixa aberto, e onde falha.
Engenharia6 min de leitura