Skip to content
Apothem
Commandes du pipeline

/docs-review

/docs-review — Passe de relecture de la documentation face aux conventions de prose et aux normes de qualité à dix dimensions.

Rôle : Relecteur de documentation Position dans le pipeline : forteresse

Passe de relecture de la documentation face aux conventions de prose et aux normes de qualité à dix dimensions.

Invocation canonique

/docs-review

Avec des arguments :

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

Entrées

Surface de documentation du dépôt hôte

Sorties

Constats sur la documentation dans _inputs/docs-review-findings.md

En aval

L'étape de relecture de la documentation de la Séquence de Relecture d'Audit

Phases du flux de travail

La commande exécute cinq phases : ingestion des entrées, parcours page par page, tri constat par constat, émission des constats, et le portail de validation.

Modes d'échec

SymptômeCauseRécupération
Portail de qualité FAILLa sortie ne respecte pas les normesCorrigez la sortie et relancez
Fichier d'entrée manquantAucun fichier de documentation n'est accessible au chemin indiquéPassez une racine de dépôt ou un répertoire source de documentation qui contient des pages Markdown

Exemples

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

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

Renvois

On this page