Notas de versão na prática
Como os times escrevem notas de versão que as pessoas realmente leem.
-
Release notes de correção de bugs: entradas úteis
Release notes de correção de bugs funcionam quando cada entrada nomeia o sintoma, quem foi atingido e o próximo passo. Reescritas e regras de segurança.
Notas de versão na prática8 min de leitura
-
Exemplos de release notes para cada tipo de mudança
Exemplos de release notes para funcionalidade, correção, breaking change, segurança, depreciação, loja de apps e nota interna, com o porquê de cada texto.
Notas de versão na prática8 min de leitura
-
Release notes de emergência sob pressão de tempo real
Releases disparadas por incidente precisam de notas escritas em minutos, não dias, e o processo normal de escrita assume um tempo que você não tem.
Notas de versão na prática6 min de leitura
-
Release notes internas: quem mais precisa saber
Suporte e vendas costumam descobrir um lançamento por um cliente confuso. Release notes internas resolvem isso, num formato diferente das notas ao cliente.
Notas de versão na prática5 min de leitura
-
Release notes para apps mobile: o que o limite corta
App Store e Play Store dão poucas linhas visíveis e sem link. O que funciona num changelog web quebra nesse limite, e os cortes precisam ser certos.
Notas de versão na prática5 min de leitura
-
Como anunciar uma funcionalidade nova (sem silêncio)
A maioria dos anúncios de funcionalidades morre em um canal que ninguém lê duas vezes. Onde anunciar, o que dizer primeiro, e quem é preciso alcançar.
Notas de versão na prática5 min de leitura
-
Release notes enterprise: o que muda para uma conta
Release notes enterprise para uma cliente em build privado precisam ser calibradas para a instância dela. Errar isso vaza o roadmap ou confunde o suporte.
Notas de versão na prática6 min de leitura
-
Changelog: o que é, com um exemplo de entrada
Changelog é o registro datado do que mudou em um produto. Um exemplo de entrada, a diferença para release notes e commit log, e onde publicar o seu.
Notas de versão na prática6 min de leitura
-
O template de e-mail de atualização de produto que é lido
O e-mail de atualização de produto que é lido foi enviado para quem pediu. Um template, os quatro tipos de e-mail, assuntos que funcionam, e consentimento.
Notas de versão na prática6 min de leitura
-
Changelog vs release notes: qual é a diferença?
Um changelog é um registro contínuo para quem procura algo. Release notes são uma mensagem selecionada para quem decide se isso importa. A divisão.
Notas de versão na prática5 min de leitura
-
Como escrever release notes que as pessoas realmente leem
«Correções de bugs e melhorias de desempenho» não é uma release note. A pergunta que cada entrada deve responder, e a reescrita de uma nota real.
Notas de versão na prática6 min de leitura
-
Melhores práticas de release notes que valem a pena
A maioria das listas de melhores práticas é conselho de estilo. Estas mudam o que o leitor faz, e três populares que são puro culto da forma.
Notas de versão na prática6 min de leitura
