Éléments pour la révision avant publication

L'élément draft-comment permet d'apporter des commentaires et des corrections dans le balisage d'une rubrique. Il est également possible d'utiliser un simple commentaire XML.

Dans un processus de documentation classique, des informations incomplètes empêcheront souvent le rédacteur de terminer une rubrique. Pour assurer le suivi et la gestion des informations incomplètes, un rédacteur peut ajouter un élément de phrase draft-comment. Cet élément peut également être utile au cours des étapes d'édition et de révision par un pair. Grâce à cet élément, cette personne peut laisser des remarques ou des suggestions que le rédacteur pourra prendre en compte et éventuellement appliquer.

<p>Le modèle MY11 XRW utilise un turbocompresseur de type AHA.
  <draft-comment author="Léo">
     Vérifier que cela n'a pas changé à l'issue de la réunion
  </draft-comment>
<p>

Il ne faut pas confondre l'élément draft-comment avec l'élément required-cleanup. L'élément required-cleanup sert à identifier les contenus migrés dans une rubrique (généralement du contenu XHTML migré vers DITA). En d'autres termes, le contenu balisé par l'élément required-cleanup doit être relu par un rédacteur afin de corriger le balisage et de conserver sa portée initiale.

Tous les contenus de type draft-comment sont normalement supprimés lors du processus de publication. Cependant, il existe des outils de rédaction qui permettent de conserver volontairement les éléments draft-comment dans le document de sortie.

L'élément draft-comment n'est pas autorisé dans tous les types de structures. Une autre solution consiste à utiliser un commentaire XML standard en tant qu'élément spécial. De nombreux outils de rédaction autorisent l'ajout de commentaires XML dans leur éditeur WYSIOO (What You See is One Option).

<!-- Vérifier que la dernière étape est requise dans le cas du modèle MY11 -->