---
title: Release da documentação
description: Checklist para publicar mudanças de documentação com confiança.
context: Validação de docs-site e integração com CI.
---

# Release da documentação

Mudança de documentação no `sdd-layer` precisa ser validada como produto. O site é uma superfície de operação: se ele quebra, novos agentes e humanos aprendem o contrato errado.

## Checklist local

```bash
cd docs-site
npm ci
npm run docs:generate -- --check
npm run docs:links
npm run build
```

Na raiz do repositório:

```bash
git diff --check
```

## Smoke visual

Abra as rotas:

- `/`
- `/comece-aqui/primeiros-15-minutos`
- `/geracao/cookbook`
- `/exemplos/export-csv-feature`
- `/reference/command-map`
- `/llms.txt`
- `/llms-full.txt`

Verifique desktop e mobile. A navegação lateral, busca, TOC e botão de copiar Markdown precisam aparecer sem sobreposição.

## Critério de pronto

| Critério | Evidência |
|---|---|
| Build passa | `npm run build` |
| Links internos passam | `npm run docs:links` |
| Referência está sincronizada | `npm run docs:generate -- --check` |
| Rotas antigas preservadas | `/guide/overview`, `/tutorials/first-orchestration`, `/reference/command-map` |
| LLM-friendly ativo | `/llms.txt`, `/llms-full.txt`, páginas `.md` |
