Como Escrever Notas de Lançamento de Software Eficazes

Discover how to lead product teams and build better products. Create a Free Account

O que são boas notas de lançamento de software? Michael Pierce partilha os principais componentes e exemplos do que funciona ou não, para que possa começar a escrever notas de lançamento que os utilizadores vão ler.

How to write effective software release notes standard editorial post 02618

Se a sua empresa for como a maioria, as notas de versão de software são algo secundário ou parecem uma tarefa inútil. São compiladas à última hora e podem incluir apenas uma ou duas frases.

Mas pode transformar aquilo que parece ser um requisito aborrecido numa excelente ferramenta para envolver a sua comunidade de clientes, fazer as pessoas rir e sorrir com a sua marca e criar confiança junto dos seus utilizadores finais. Esta é a sua oportunidade de comunicar com a sua base de clientes e sinalizar ao mercado o nível de qualidade do seu processo de desenvolvimento de software.

Ao dedicar tempo a escrever notas de versão eficazes, pode aumentar a satisfação dos clientes e a adoção do produto. Isto melhora a experiência do utilizador de forma mais abrangente. Além disso, estabelece um precedente de que a sua empresa gere o seu ciclo de vida de entrega de software como uma máquina bem oleada.

Quando era coproprietário e geria a gestão de produto & o marketing de produto na DigiQuatics, aproveitei o blogue da empresa para as nossas atualizações de produto, complementando-o com pequenas publicações fáceis de consumir sobre as atualizações de produto nas redes sociais, com ligações para o blogue, e utilizando finalmente a lista de subscritores do blogue para enviar uma atualização por e-mail.

Criar este sistema em torno do nosso processo de notas de versão permitiu aos nossos clientes saber que o seu feedback não só era ouvido, como também posto em prática. Isto criará confiança junto dos nossos utilizadores finais e permitirá que o trabalho árduo dos gestores de produto e das equipas de engenharia se destaque perante o resto do mundo. 

Pode encontrar aqui um exemplo de uma das nossas atualizações de produto da DigiQuatics.

Como criar notas de versão de software impactantes

As notas de versão de software são uma oportunidade para manter os seus clientes entusiasmados com o seu produto. Destaque as novas funcionalidades e correções de erros de uma forma fácil de compreender para os clientes. No entanto, certifique-se de que inclui palavras-chave para que os utilizadores finais possam encontrar facilmente informações sobre a versão no Google ou através da funcionalidade de pesquisa do seu blogue. 

imagem do SpongeBob

É importante ser claro, conciso e informativo ao escrever notas de versão de software. Eis algumas dicas sobre como escrever notas de versão eficazes (tenha em mente que este é um excelente caso de utilização de AI na gestão de versões):

  • Seja claro – sobre o que há de novo na versão. Que funcionalidades ou capacidades está a lançar? De que forma irão beneficiar os seus clientes?
  • Mantenha o foco no cliente – as notas de versão não são engenheiros a escrever para engenheiros; lembre-se do cliente enquanto escreve as suas notas e reserve o jargão técnico para os membros da equipa técnica
  • Destaque as correções de erros – Não se esqueça de mencionar que erros e defeitos foram corrigidos. Os clientes ficarão satisfeitos por ver que ouviu o seu feedback e respondeu às suas preocupações
  • Tenha atenção ao tom – das suas notas de versão. Quer transmitir entusiasmo pelas melhorias do produto sem parecer que as está a promover em excesso. Afinal, as notas de versão não são um discurso de vendas
  • Inclua algum conteúdo – Capte a atenção dos seus utilizadores, adicione vídeos incorporados e capturas de ecrã, GIFs, ligações relevantes e até apresente o roteiro do produto quando for apropriado

Embora não exista uma regra rígida e definitiva, seguir esta estrutura resultará numa nota de versão bem escrita e completa. Pense nisto como o seu modelo de notas de versão para as suas novas funcionalidades, melhorias e correções de erros.

  • Título
    • O seu título ou cabeçalho para cada nova funcionalidade, função ou atualização da aplicação
  • Descrição
    • Algumas frases sobre o que há de novo, quais foram as melhorias ou como foi resolvido o erro
  • Meios incorporados
    • Quaisquer capturas de ecrã, vídeos ou outro conteúdo de apoio que possam dar mais contexto sobre a nova funcionalidade, função ou correção de erros
  • Ligações relevantes
    • Quaisquer ligações relevantes para documentação ou informações técnicas sobre o produto destinadas aos engenheiros do público que possam precisar de aprofundar o assunto. Um bom exemplo são as informações sobre o consumo da API das suas aplicações. Mas lembre-se: as notas de lançamento devem ser mantidas num nível geral, concisas e divertidas

Muitas empresas incluem também declarações de exoneração de responsabilidade sobre a própria empresa ou sobre o produto específico a que as notas de lançamento dizem respeito. É igualmente uma boa prática incluir um endereço de e-mail ou uma ligação para uma página de contacto, para que os clientes possam contactá-lo, conforme necessário, sobre as notas de lançamento do produto.

Get Free Access to the Product Vault
We’ve collected the goods — AI prompts, exclusive deals, and a library of resources for product leaders. Unlock your account for access.
Get Free Access

Have an account? Log In

Exemplos de notas de lançamento de software 

Exemplos de excelentes notas de lançamento de empresas SaaS líderes

Slack

captura de ecrã das notas de lançamento do produto Slack
Slack — Notas de lançamento do produto

O Slack tem uma abordagem única às notas de lançamento de software. Está alinhada com o tom de voz “divertido” da marca, partilhado pelas suas equipas de marketing. As notas transmitem uma sensação descontraída, conversacional e divertida. Isto contrasta com muitas empresas, cujas notas de lançamento de software acabam por ser secas, aborrecidas e conter jargão técnico.

Chegam até a resumir várias notas das notas de lançamento de software para as utilizarem nos seus canais de redes sociais, mantendo os utilizadores finais atualizados sobre as novidades do Slack. As notas de lançamento de software como as do Slack aparecem normalmente nas lojas de aplicações.

Intercom

captura de ecrã das notas de lançamento do produto Intercom
Intercom — Notas de lançamento do produto

A forma como a Intercom gere as suas notas de lançamento é uma das minhas favoritas para uma empresa SaaS. Como os seus clientes tendem a ser proprietários de empresas, desde lojas Shopify a fornecedores de SaaS e grandes empresas, os utilizadores finais que recebem estas atualizações de funcionalidades tendem a ser equipas internas com conhecimentos técnicos intermédios.

Assim, ter os lançamentos mais recentes num formato de blogue, com um resumo conciso do problema e muitos GIF, capturas de ecrã, vídeos e explicações passo a passo para um novo lançamento é excelente, sendo também uma ótima forma de gerir a entrega de atualizações de funcionalidades e notas de lançamento de software. Este formato de notas de lançamento de produtos é igualmente excelente para e-mails ou notificações na aplicação.

Ahrefs

captura de ecrã das notas de lançamento do produto Ahrefs
Ahref — Notas de lançamento do produto

A Ahref adota uma abordagem semelhante à da Intercom, utilizando um formato de blogue para as suas notas de lançamento de produtos. O que quero destacar aqui é a forma como amplificam a notoriedade junto dos utilizadores.

Adicionam um banner no topo da página Web do seu produto SaaS. É uma forma inteligente de informar os utilizadores finais sobre o que podem esperar das novas atualizações. Não precisam de depender de e-mails que podem acabar nos filtros de spam nem de um feed de redes sociais que muitos utilizadores provavelmente desconhecem.

Exemplos do que deve evitar nas notas de lançamento de software

Uber

captura de ecrã das notas de lançamento da Uber
Uber — Notas de lançamento do produto na loja de aplicações

Embora goste da chamada de atenção para que os utilizadores finais avaliem a aplicação Uber e forneçam feedback, este é um exemplo de uma atualização de notas de versão de software pouco desenvolvida.

Como foi melhorada a localização e quais foram as correções de erros e as melhorias de desempenho? Esta atualização da aplicação é vaga e não oferece qualquer informação concreta sobre o que será alterado.

Instagram

captura de ecrã das notas de versão do Instagram
InstagramNotas de versão do produto na App Store

Este é outro exemplo de notas de versão de software pouco cuidadas. Uma única frase genérica “A versão mais recente contém correções de erros e melhorias de desempenho.” Esta atualização não dá aos utilizadores finais qualquer indicação sobre as atualizações de funcionalidades que poderão estar incluídas nesta nova versão, nem sobre a existência de alterações significativas à funcionalidade.

More Articles

Ferramentas para Divulgar Notas de Versão de Software

Existem muitas ferramentas que pode utilizar para simplificar as notas de versão do produto. Para além da abordagem mais tradicional de um blogue e/ou da utilização de uma lista de e-mails para fornecer atualizações sobre as novidades ou o resumo que encontra para as atualizações das aplicações em várias lojas de aplicações.

  • AnnounceKit: “A AnnounceKit ajuda as empresas a comunicar atualizações e novidades dos produtos aos seus clientes, a aumentar a adoção de funcionalidades e a criar confiança junto dos clientes.”
  • ReleaseNotes: “Crie notas de versão bonitas e envolventes para manter os clientes e as partes interessadas atualizados, ou utilize-as como ferramenta de marketing para converter mais. Publicar e promover notas de versão aumenta a notoriedade, o envolvimento e a confiança.“
  • MagicBell: “A caixa de entrada de notificações do seu produto. Adicione uma MagicBell ao seu produto para anúncios, faturação, fluxos de trabalho e outras notificações.“

Para facilitar o seu processo, consulte a nossa lista de ferramentas de gestão de versões de software.

Conclusão

Ao seguir estas dicas, pode escrever notas de versão eficazes e informativas. Os clientes apreciarão o esforço que faz para os manter atualizados sobre as alterações ao produto.

Obrigado por ler! Tem outras dicas para escrever notas de versão? Partilhe-as nos comentários abaixo! E não se esqueça de subscrever a newsletter!

Leitura relacionada: Ciclo de Vida de uma Versão de Software (SRLC): Compreenda as 6 Etapas Principais

Lista de ferramentas relacionada: Ferramentas de Gestão de Versões de Software

Podcast relacionado: Preços de Produtos: Estratégia Baseada no Valor e Empacotamento de Software, com Dan Balcauski

Veja também: Software de Gestão de Ideias para Gerir Novas Ideias para Produtos

Michael Pierce
Michael Pierce boasts an extensive career spanning nearly fifteen years, encompassing roles in entrepreneurship, product management, and software engineering. His diverse experience includes contributions to startups, scale-ups, enterprises, and consultancies. Most recently, he has served as a Director of Product Management, specializing in the GovTech and HealthTech sectors.
Follow the author:

You may also like