Rôle d'un guide de style

Un guide de style donne des conseils sur l'utilisation optimale des approches, des procédures et des processus. Un guide de style DITA se concentre sur l'application des meilleures pratiques de la norme DITA.

Le principal objectif des guides de style est de promouvoir la cohérence. Ils cherchent également à codifier les meilleures pratiques. La véritable signification de l'expression meilleures pratiques n'est pas comprise ou acceptée de façon universelle. La compréhension de ce que constituent les meilleures pratiques dans DITA n'est pas chose facile en raison de la difficulté à trouver des pratiques communes dans ce domaine, sans parler des meilleures pratiques. Une chose aussi simple que l'existence de paragraphes au sein d'un élément de liste n'est pas clair.

Un manuel de style ou un guide de style est un ensemble de normes régissant la conception et la rédaction de documents, et prend généralement la forme d'un manuel imprimé. Les organisations de publication, les organismes de normalisation, les agences gouvernementales et les services de publication au sein d'une organisation sont typiquement les auteurs des manuels de style. Les manuels de style de publication technique utilisés par les rédacteurs techniques, tels que le manuel de style AGPS et le manuel de style Chicago - The Chicago Manual of Style, consacrent un certain nombre de chapitres au processus de publication, qui, dans le modèle DITA, est retiré du domaine des rédacteurs techniques. Inversement, très peu d'espace est consacré à l'identification sémantique des éléments de contenu, quelque chose de primordial dans DITA. L'objectif principal d'un manuel de style est de promouvoir la cohérence, et l'une des difficultés de l'adoption de DITA est de travailler sans un guide de style approprié au paradigme DITA.

Il est aussi simple de créer des documents DITA mal balisés que de créer des documents de traitement de texte mal rédigés. Pour optimiser les fonctionnalités de DITA, il est important que les éléments sémantiques soient appliqués de façon cohérente et uniforme au sein d'un service de publication et, bien évidemment, au sein de la communauté de rédaction DITA. Guide de Style DITA est destiné à servir de référence faisant autorité en définissant les conventions en matière de meilleures pratiques pour le balisage, le style de rédaction, le nommage des fichiers et leur structuration.