> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Governança de versionamento

> Entenda a governança de versionamento da Lerian, como as mudanças são comunicadas, como as dependências permanecem compatíveis entre releases e o compromisso da Lerian com a compatibilidade retroativa.

Uma governança clara mantém o processo de versionamento transparente e confiável. Aqui detalhamos como as mudanças são comunicadas, como as dependências são gerenciadas e nosso compromisso de longo prazo com a compatibilidade retroativa.

Isso te dá visibilidade total sobre como o Midaz evolui e como protegemos sua estabilidade ao longo do caminho.

## Comunicação de mudanças

***

Comunicamos cada mudança com clareza para que os times possam se preparar e se adaptar com confiança.

* **Notas de release** incluem novas funcionalidades, melhorias, correções de bugs, problemas conhecidos e breaking changes com caminhos de migração.
* **Atualizações de documentação** refletem mudanças de API, novas configurações e comportamentos atualizados.
* **Anúncios de pré-release** são compartilhados antecipadamente para versões major.

## Versionamento de dependências

***

Dependências são versionadas com os mesmos princípios para garantir estabilidade e compatibilidade.

* **Dependências internas** seguem o mesmo esquema de versionamento do Midaz.
* **Dependências externas** são gerenciadas para permanecerem compatíveis durante todo o ciclo de vida de uma versão major.

## Compromisso com a compatibilidade retroativa

***

Esta política de versionamento se aplica a cada nova release, garantindo estabilidade em toda a plataforma. Nos comprometemos a manter as **janelas de suporte** definidas para todas as versões futuras, para que os times possam adotar upgrades com confiança e sem interrupções inesperadas.

Ao preservar a compatibilidade retroativa, reduzimos o risco de breaking changes e damos às organizações a flexibilidade de planejar upgrades no próprio cronograma. Essa abordagem mantém as integrações estáveis enquanto permite que o Midaz evolua em um ritmo sustentável.

<Tip>
  Para detalhes sobre prazos e cronogramas, veja a página de [Ciclo de release](/pt/updates-and-versioning/release-cycle).
</Tip>
