Runbook — Publicação das docs

Publicar é ato autorizado, nunca automático. Nenhum agente de IA publica por iniciativa própria.

observação

O destino de publicação (servidor/URL) ainda é UNKNOWN — será definido quando a infraestrutura estiver aprovada. Este runbook define o processo; o passo 4 será completado com o destino real.

Pré-condições (gate de publicação)

Publicação só pode acontecer se todas forem verdadeiras:

1. npm run docs:check = PASS na versão exata a publicar (evidência: output do comando).
2. Trabalho commitado em main — nada de publicar working tree suja.
3. Autorização explícita do Founder para esta publicação.
4. Nenhum documento DRAFT exposto em navegação como se fosse regra vigente.

Processo

1. Validar

cd site
npm run docs:check

Guardar o output como evidência (PASS requer evidência).

2. Marcar o release

git tag docs-vX.Y -m "Docs release X.Y: <o que mudou>"
git push --tags   # quando houver remote

3. Gerar o build

npm run build

Artefato: pasta site/build/ (estática, pronta para qualquer servidor).

4. Publicar no destino

UNKNOWN — a definir (VM + Docker + Caddy planejados). Ao definir o destino, atualizar este runbook com os comandos exatos e incrementar a versão.

5. Verificar e registrar

• Abrir a URL publicada e conferir: página inicial, uma página de cada seção, busca.
• Registrar a publicação: data, tag, quem autorizou, evidência do check.