Página de visão geral do produto
O ponto de entrada para um produto ou plugin. Responde três perguntas: o que é, por que usar e como funciona.
1
Título e subtítulo
Use “What is [Product]?” como título. Adicione um subtítulo de uma linha no campo
description do frontmatter que resuma o produto em linguagem simples.2
Parágrafo de abertura
Duas a três frases. Declare o que o produto é, o que faz e onde se encaixa no ecossistema Lerian. Mencione o modelo de licenciamento (source-available para o Midaz e o Fetcher, ou Enterprise / licenciado para outros produtos) e link para o repositório público no GitHub apenas quando o produto for source-available; caso contrário, indique que seu repositório é mantido internamente.
3
Por que usar [Product]
Enquadre o problema que o produto resolve. Use uma lista de bullets para as principais propostas de valor. Cada bullet começa com um rótulo em negrito seguido de dois pontos e uma explicação de uma linha.
4
O que [Product] faz
Liste as capacidades principais como bullets. Siga com uma subseção “Built for” se o produto atende públicos distintos (fintechs, bancos, empresas).
5
Casos de uso comuns
Use um
<AccordionGroup> com 3-5 casos de uso. Cada accordion tem um título curto e uma descrição de 2-3 frases do cenário.6
Como [Product] funciona
Use um componente
<Steps> para guiar o fluxo de trabalho de alto nível (4-6 passos). Cada passo tem um título baseado em verbo e uma explicação de 1-2 frases.7
Integrações (opcional)
Uma tabela mapeando produtos Lerian relacionados ao que eles adicionam.
8
Próximos passos
Um
<CardGroup cols={2}> com 3-4 cards apontando para: arquitetura/conceitos, início rápido, casos de uso e referência de API.Página de arquitetura e conceitos
Explica a estrutura interna de um produto — seus domínios, entidades e como se relacionam. Esta é a página “Sobre [Product]”.
1
Parágrafo de abertura
Um parágrafo que posiciona o produto arquiteturalmente. Mencione o domain-driven design se aplicável.
2
Domínios ou componentes
Divida o produto em seus domínios lógicos (ex.: Domínio de Onboarding, Domínio de Transações). Cada domínio recebe um heading H3 com:
- Uma breve descrição do seu propósito
- Uma lista de bullets dos seus componentes, cada um com um nome em negrito e uma definição de uma linha
3
Tabela resumo
Finalize com uma seção “Em resumo” contendo uma tabela que mapeia domínios ao seu propósito e APIs principais.
Página de primeiros passos
Um tutorial prático que leva o leitor do zero a uma configuração funcional. Objetivo: menos de 15 minutos.
1
Título e subtítulo
Use “Getting started with [Product]” como título. O subtítulo deve definir expectativas: o que o leitor vai realizar e quanto tempo leva.
2
Pré-requisitos
Uma tabela listando ferramentas necessárias com versões mínimas e comandos de verificação.
Adicione uma
<Note> para compatibilidade de SO.3
Passos numerados
Cada passo é um H2 com o formato “Step N — [Verbo] [objeto]” (ex.: “Step 1 — Clone the repository”). Dentro de cada passo:
- Uma explicação de 1-2 frases do que o passo faz e por quê
- Um bloco de código com o comando exato
- Uma
<Tip>ou<Note>para detalhes importantes (portas, valores padrão, pegadinhas)
4
Passo de verificação
Sempre inclua um passo final que confirme que a configuração funciona (ex.: verificar um saldo, consultar um endpoint de status).
5
Próximos passos
Um
<CardGroup cols={2}> apontando para entidades, transações, casos de uso e explorador de API.Página de referência de entidade
Documenta uma única entidade principal (Account, Ledger, Transaction, Holder, etc.). Explica o que é, como se comporta e como usar.
1
Definição de abertura
Um parágrafo definindo a entidade, seu papel no sistema e seu relacionamento com outras entidades.
2
Conceitos principais
Explique comportamentos e regras-chave. Use subseções H3 para conceitos distintos. Inclua diagramas (
<Frame>) quando os relacionamentos são complexos.3
Exemplos de código
Use
<CodeGroup> para mostrar exemplos JSON e DSL lado a lado quando ambos forem suportados. Use payloads realistas.4
Diagramas visuais
Use
<Frame caption="Figura N. Descrição"> para diagramas de arquitetura, fluxo ou relacionamento de entidades.5
Páginas relacionadas
Link para a referência de API, entidades relacionadas e guias relevantes.
Página de guia
Explica como realizar uma tarefa específica ou implementar um caso de uso. Orientada a tarefas e contextual — explica o “porquê” junto com o “como”.
1
Contexto de abertura
Um a dois parágrafos explicando o que o leitor vai realizar, para quem é o guia e qual problema resolve. Seja específico — não “aprenda sobre X” mas “configure X para lidar com Y”.
2
Pré-requisitos
O que já deve estar configurado ou compreendido. Link para páginas relevantes.
3
Instruções passo a passo
Use seções H2 para fases principais. Dentro de cada fase, use passos numerados ou componentes
<Steps>. Comece cada passo com um verbo.Inclua:- Blocos de código com payloads realistas
<Tip>para boas práticas<Warning>para armadilhas comuns<Note>para contexto importante
4
Verificação
Como o leitor confirma que a tarefa foi concluída com sucesso.
5
Próximos passos
Cards ou links para guias relacionados, conceitos mais aprofundados ou referências de API.
Página de visão geral do plugin
Visões gerais de plugins seguem a mesma estrutura das páginas de visão geral de produto, com estas adições:
- Declare claramente o modelo de licenciamento do plugin (por exemplo, source-available quando distribuído dentro do repositório do Midaz, ou Enterprise / licenciado caso contrário) e se requer uma licença.
- Especifique o relacionamento de versionamento com o Midaz (ex.: “A versão do CRM sempre corresponde à versão do Midaz Core”).
- Inclua uma seção de modelo de deploy: como o plugin é implantado em relação ao Midaz (independentemente, mesmo namespace, etc.).
- Adicione uma seção de requisitos listando o que a instituição precisa para operar o plugin (ISPB, provedor de conectividade, maturidade de DevOps, etc.).
- Se aplicável, inclua uma seção de trade-offs e desafios que descreva honestamente as responsabilidades operacionais que o plugin introduz.
Padrões de componentes
Estes componentes Mintlify aparecem em todos os templates de guias. Use-os de forma consistente.