Skip to content
Apothem
Comandos do pipeline

/docs-review

/docs-review — Passagem de revisão de documentação frente às convenções de prosa e aos padrões de qualidade de dez dimensões.

Papel: Revisor de documentação Posição no pipeline: fortaleza

Passagem de revisão de documentação frente às convenções de prosa e aos padrões de qualidade de dez dimensões.

Invocação canônica

/docs-review

Com argumentos:

/docs-review [path/to/repo/ or path/to/docs-source/] [--focus FILE_OR_DIR] [--dry-run]

Entradas

Superfície de documentação do repositório anfitrião

Saídas

Achados de documentação em _inputs/docs-review-findings.md

Downstream

A etapa de revisão de documentação da Sequência de Revisão de Auditoria

Fases do fluxo de trabalho

O comando executa cinco fases: ingestão de entrada, percurso por página, triagem por achado, emissão de achados e o portão de validação.

Modos de falha

SintomaCausaRecuperação
Portão de qualidade FAILA saída não atende aos padrõesCorrija a saída e execute novamente
Arquivo de entrada ausenteNenhum arquivo de documentação é acessível no caminhoInforme uma raiz de repositório ou um diretório de fontes de documentação que contenha páginas em Markdown

Exemplos

# Dry-run to preview what would happen
/docs-review --dry-run

# Execute against a repository root
/docs-review path/to/repo/

Referências cruzadas

On this page