> ## 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.

# Melhoria da documentação Helm

> A documentação Helm agora fica sob a aba Platform como uma referência organizada por produto, cobrindo instalação, upgrades, migração, troubleshooting e configuração em produção.

<Badge stroke icon="calendar-days" iconType="regular">10 de abril de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Atualização de documentação</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Revisão recomendada</Badge>

## Afeta

***

Times usando a documentação de deployment Helm.

Esta atualização se aplica ao portal público de documentação. Não altera o comportamento da API em runtime, a menos que a documentação do produto vinculada diga o contrário.

## O que mudou

***

A documentação Helm passou por uma reestruturação completa nesta semana. O que antes eram algumas páginas monolíticas agora é uma referência organizada por produto cobrindo instalação, upgrade, migração, troubleshooting e configuração em produção.

### Nova estrutura: Helm por produto

***

A seção Helm foi reorganizada sob a aba Platform e agrupada por produto, para que você possa ir direto à referência do que está fazendo deploy.

* [**Helm overview**](/pt/platform/helm/helm-overview) — Hub central com links para toda a documentação Helm específica de cada produto
* [**Version compatibility**](/pt/platform/helm/helm-version-compatibility) — Matriz atualizada com documentação do OCI registry e esclarecimento sobre versionamento de chart

### Midaz (16 novas páginas)

A documentação Helm do Midaz foi dividida de duas páginas grandes em seções focadas e navegáveis:

* **Install & Configure** — [Installation](/pt/platform/helm/midaz/midaz-installation), [Configuration reference](/pt/platform/helm/midaz/midaz-configuration-reference), [Dependencies](/pt/platform/helm/midaz/midaz-dependencies), [Ingress](/pt/platform/helm/midaz/midaz-ingress), [Components reference](/pt/platform/helm/midaz/midaz-components-reference)
* **Upgrading** — [Upgrade guide](/pt/platform/helm/midaz/midaz-upgrade-guide), [Upgrade checklist](/pt/platform/helm/midaz/midaz-upgrade-checklist)
* **Migrating** — [v3 → v4](/pt/platform/helm/midaz/midaz-migrate-v3-to-v4), [v4 → v5](/pt/platform/helm/midaz/midaz-migrate-v4-to-v5), [v3 → v5](/pt/platform/helm/midaz/midaz-migrate-v3-to-v5)
* **Operations** — [Troubleshooting](/pt/platform/helm/midaz/midaz-troubleshooting), [Rollback & troubleshooting](/pt/platform/helm/midaz/midaz-rollback-troubleshooting), [Observability](/pt/platform/helm/midaz/midaz-observability), [Uninstall](/pt/platform/helm/midaz/midaz-uninstall)
* **Production** — [Production values reference](/pt/platform/helm/midaz/midaz-production-values) — values.yaml completo e anotado para deployments em produção

### Plugins (7 novas páginas)

Cada plugin agora tem sua própria página de referência Helm:

* [**Plugins overview**](/pt/platform/helm/plugins/plugins-helm-overview)
* [Pix](/pt/platform/helm/plugins/plugin-pix-helm), [Pix Indirect](/pt/platform/helm/plugins/plugin-pix-indirect-helm), [CRM](/pt/platform/helm/plugins/plugin-crm-helm), [Fees](/pt/platform/helm/plugins/plugin-fees-helm), [Bank Transfer](/pt/platform/helm/plugins/plugin-bank-transfer-helm)

### Outros produtos (4 novas páginas)

* [**Reporter**](/pt/platform/helm/reporter/reporter-helm)
* [**Console**](/pt/platform/helm/console/console-helm)
* [**Access Manager**](/pt/platform/helm/access-manager/access-manager-helm)
* [**Infrastructure**](/pt/platform/helm/infrastructure/infrastructure-helm)

### Nova página: Deployment Models

***

Uma nova página [**SaaS e BYOC**](/pt/deployment-models) explica os dois modelos de deployment (SaaS totalmente gerenciado vs. Bring Your Own Cloud), incluindo quando usar cada um, o que Helm significa no contexto BYOC, e links para toda a documentação Helm específica de cada produto.

### Páginas removidas

As seguintes páginas monolíticas foram removidas e seu conteúdo redistribuído na nova estrutura:

* `helm-overview.mdx` (seção antiga do Midaz) — substituída por [Platform Helm overview](/pt/platform/helm/helm-overview) e [Midaz Helm overview](/pt/platform/helm/midaz/midaz-helm-overview)
* `helm-upgrade-guide.mdx` — substituída por [Upgrade guide](/pt/platform/helm/midaz/midaz-upgrade-guide) dedicado e páginas de migração
* `upgrading-helm.mdx` — conteúdo mesclado no guia de upgrade e no checklist

### Melhorias de conteúdo

* **Contexto de negócio** — As páginas Helm agora incluem contexto de decisão e enquadramento "por que isto importa", não apenas instruções de configuração
* **Orientações para produção** — Nova referência de production values com valores anotados e recomendações de recursos
* **Troubleshooting** — Troubleshooting abrangente baseado em sintomas, cobrindo pods, ingress, bancos de dados, RabbitMQ e operações Helm
* **Caminhos de migração** — Guias detalhados passo a passo para cada transição de versão suportada (v3→v4, v4→v5, v3→v5), com breaking changes e procedimentos de rollback
* **Navegação** — Sentence case aplicado a todos os cabeçalhos Helm, links duplicados de páginas de deployment removidos
* **Portas de rede** — Referência [default network ports](/pt/reference/default-network-ports) atualizada

## Impacto

***

Esta é uma atualização de documentação. Integrações existentes não precisam migrar apenas com base nesta release note.

## O que você precisa fazer

***

<Steps>
  <Step>
    Use a documentação Helm organizada por produto ao planejar instalação, upgrade, migração, troubleshooting ou configuração em produção.
  </Step>
</Steps>

### Prazo

Nenhum.

### Por quê

A documentação Helm foi movida para uma estrutura de Platform e reorganizada por produto.
