Écrire en vue de réutiliser

Du contenu écrit en vue d’être réutilisé doit être :

  • Cohérent
  • Indépendant du contexte
  • Général

Vous pouvez vous assurer qu’un fragment de contenu est assez générique pour le réutiliser, séparez les informations spécifiques des informations communes chaque fois que possible.

Pour rendre votre contenu cohérent :

  • Écrire des rubriques courtes et granulaires. Cette approche maximise le potentiel de réutilisation. Une rubrique avec un seul niveau de hiérarchisation peut être réutilisé plus souvent qu’une longue rubrique comprenant plusieurs sections chacune très riche en information.
  • Définir un guide de style pour le balisage et l’utilisation (ou au moins, se mettre d’accord sur les pratiques et prendre un peu de temps pour rédiger un compte rendu pour un future guide de style).
  • Employer un vocabulaire et une terminologie cohérente et spécifique pour rendre le contenu de vos rubriques réutilisables. Limiter l’usage des pronoms (en particulier ceux réservés à un seul genre), les expressions idiomatiques et les collocations. Cette bonne pratique viendra également faciliter la traduction du contenu.

Pour décontextualiser votre contenu :

  • Ne pas faire de référence à des informations situées avant ou après le contenu. Éviter des termes comme « précédemment », « suivant », « avant » et « plus tard» .
  • Ne pas faire de référence au type de document accueillant le contenu. Éviter des expressions telles que « dans ce chapitre » ou « dans cette section ».
  • Ne pas utiliser de références croisées. Dans la version actuelle de votre rubrique, la cible de la référence est disponible, néanmoins peut-être qu’elle ne le sera pas dans une autre carte dita où la rubrique sera réutilisée. À la place, utiliser la table des relations DITA pour gérer automatiquement les liens vers les rubriques associées.

Pour rendre votre contenu générique :

  • Éviter l’usage de mots clefs et de dépendances. Par exemple, si une série d’instructions peut être réutilisée pour plusieurs produits, retirer toute référence à un produit spécifique.
  • Éviter d’être trop spécifique à moins que le contexte l’impose. Éviter également les ajouts superflus dans votre contenu tels que des chiffres, un changement de taille ou de couleur de police, car ces modifications ne seront peut-être pas pertinentes lors de la réutilisation de ce contenu.

Pour trouver un équilibre entre un contenu générique et assez spécifique, penser à ajouter un tableau ou une liste au début de chaque livrable. Ce document servira à lister des informations sur le produit. En donnant ces informations dès le départ, vous pouvez vous passer de mots clés et opter pour des termes génériques.

Du contenu générique va non seulement profiter à votre stratégie de réutilisation de contenu, mais aussi aider à préparer en amont la localisation. En effet, la réalisation de contenu réduit le volume de texte à traduire, et par extension le coût de traduction.

Contributors