Directives de réutilisation du contenu
Les directives de réutilisation du contenu peuvent aider à rédiger plus facilement en vue de la réutilisation.
Lorsque vous rédigez dans un environnement DITA, au niveau de la rubrique plutôt qu'au niveau du document, il existe quelques directives utiles destinées à faciliter la réutilisation :
- Évitez l'utilisation de
précédent(e)
,suivant(e)
,avant
etaprès
(comme dansVeuillez trouver ci-après plus d'informations sur les limitations du produit
). Les rubriques auxquelles vous faites référence n'apparaissent pas forcément dans toutes les collections. Elles peuvent aussi apparaître mais pas dans le même ordre. - N'utilisez pas de numéros séquentiels dans les noms de fichiers : ayez plutôt recours à des noms descriptifs. (Nommez votre fichier ej20_schema_moteur.png plutôt que image1.png.)
- Évitez d'inclure des marques dans les images.
- Évitez d'inclure du contexte dans des étapes ou des
paragraphes explicatifs. Par exemple, n'écrivez pas
Le moteur EJ20 de la Supara Impress est un moteur atmosphérique
; mais écrivez plutôtLe moteur EJ20 est un moteur atmosphérique
. - Déplacez les informations contextuelles dans des paragraphes qui leur sont propres (ou l'élément context, pour les rubriques de tâche). Dans l'exemple précédent concernant l'EJ20, les informations sur les modèles de voitures qui utilisent l'EJ20 et les autres informations relatives à l'association entre l'EJ20 et la Supara, peuvent être rédigées dans un paragraphe séparé. Lorsque le contenu doit être réutilisé dans le manuel d'un produit différent, ce paragraphe de contexte peut être éliminé par filtrage et le contenu restant, non-contextuel, peut être réutilisé.