Aller au contenu

docs-deploy

docs-deploy est l’étape finale du workflow documentaire.

Cette page décrit quand publier, à quelles conditions, et avec quels garde-fous.

Rôle pratique

docs-deploy sert à publier une documentation déjà validée.

Il ne sert pas à tester un lot encore incertain.

Position dans le workflow

docs-check
-> docs-report
-> docs-deploy

Prérequis

Avant docs-deploy, il faut :

  • un docs-check propre ;
  • un docs-report relu ;
  • un lot documentaire finalisé ;
  • aucune ambiguïté majeure sur la structure ou la navigation.

Quand l’utiliser

Utiliser docs-deploy :

  • pour publier un lot documentaire stabilisé ;
  • après validation d’une réorganisation ;
  • après une mise à niveau jugée diffusable ;
  • jamais comme étape exploratoire.

Résultat attendu

Après docs-deploy, la documentation publiée doit représenter :

  • un état cohérent ;
  • un lot relisible ;
  • une structure navigable ;
  • une version assumée comme référence documentaire courante.

Garde-fous

docs-deploy ne doit pas :

  • compenser un docs-check raté ;
  • publier un lot incomplet par habitude ;
  • servir de prévisualisation bricolée ;
  • être lancé sans relecture minimale du rapport.

Voir aussi