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

# Backstage e TechDocs

> Como a documentação interna convive com a documentação pública.

# Backstage e TechDocs

O Refy agora separa duas camadas:

## Pública

Mintlify para:

* portal de documentacao
* navegacao de produto e API
* referencia gerada por OpenAPI

Arquivos públicos centrais:

* `docs.json`
* `*.mdx` e as pastas de documentacao do Mintlify na raiz do repositorio
* `openapi/refy-rest.yaml`

## Interna

Backstage para:

* catálogo de software
* TechDocs
* ownership
* descoberta interna de APIs

Arquivos centrais:

* `catalog-info.yaml`
* `mkdocs.yml`
* `docs/`

## Regra prática

Não misture o app do produto com o portal público de documentação.

O produto continua no app web.
O portal público de docs vive no Mintlify.

## Resultado esperado

Essa separação evita três erros:

* documentação competindo com a UI do produto
* contrato técnico espalhado
* catálogo interno e portal público divergindo sem necessidade