Pular para o conteúdo principal
REVIEW · v0.1Aguardando aprovação humana. Este documento NÃO é regra vigente — leia como proposta.

Como usar esta documentação

Lendo​

  1. Confie no status, não na aparência. Todo documento declara status no topo. Somente APPROVED é regra vigente. DRAFT e REVIEW são propostas; SUPERSEDED/ARCHIVED são histórico.
  2. Um assunto = um documento canônico. Se dois documentos parecem responder a mesma pergunta, o Governance Index define qual vence.
  3. UNKNOWN é resposta legítima. Quando um documento diz UNKNOWN, ninguém estabeleceu o fato ainda — não preencha com suposição.

Editando​

  1. Leia o Documentation Standard e o Naming & Versioning antes da primeira edição.
  2. Edite o Markdown em site/docs/ — nunca o HTML gerado.
  3. Valide antes de commitar: npm run docs:check (ver runbook de build).
  4. Commit descreve o que mudou e por quê. Mudança material em documento APPROVED incrementa versão.
  5. O processo completo (humanos e agentes de IA) está no CONTRIBUTING.md na raiz do repositório.

O que nunca fazer​

  • Criar cópia "de trabalho" de um documento canônico (edite o original ou proponha via DRAFT).
  • Deixar decisão importante apenas em chat, e-mail ou WhatsApp — registre na seção Decisões ou no Decision Log do projeto.
  • Nomear arquivo com FINAL, latest, corrected ou variantes — o docs:check bloqueia.
  • Aprovar documento por conta própria sendo um agente de IA — aprovação é humana, sempre.