# Une architecture documentaire trop complexe ?

## Définition

DITA XML permet des gains de productivité importants par la réduction du volume source que le rédacteur technique crée, traduit et maintient. Ce gain de productivité se fait au prix d'une plus grande complexité.

## Compromis

Si les projets DITA XML sont plus *complexes*, ils sont cependant moins *compliqués* que des projets reposant sur des formats plus traditionnels de type FrameMaker. En effet, DITA XML est une architecture rationnelle. Le rédacteur technique se trouve donc face à un comportement prédictible des outils qu'il utilise, loin des *trucs et astuces* destinés à contourner les bugs ou les fonctionnements erratiques des outils plus lourds.

> **Schéma: DITA XML est complexe mais prévisible, les formats traditionnels sont compliqués et erratiques**
>
> Diagramme du cadre Cynefin plaçant DITA XML dans le domaine complexe, car son comportement est rationnel et prévisible malgré sa complexité, et les formats traditionnels comme FrameMaker dans le domaine compliqué, en raison de leur comportement erratique nécessitant contournements et astuces.

**DITA XML est complexe mais prévisible ; les formats traditionnels sont compliqués et erratiques.**

## Exemples

La présentation suivante expose les différents niveaux de complexité induits par DITA XML et les solutions qui permettent au rédacteur technique de les maîtriser plus facilement :

  
### <span role=

Syntaxe DITA XML</span>'>
    **Solution :** IDE (Integrated Development Environment) tel que XMetaL ou nXML

  
### <span role=

Gestion des relations entre des briques d&apos;information atomiques</span>'>
    **Solution :** CMS (Content Management System) dédié tel que Componize ou DocZone

  
### <span role=

Syntaxe de la feuille de style XSLT</span>'>
    **Solution :** Logiciel graphique de création de feuilles de style

Pour une petite équipe de rédaction technique, l'écueil principal sera la nécessité de mettre en œuvre la charte graphique de l'entreprise. Les autres aspects peuvent être gérés sans outil spécialisé, avec une bonne communication et une série de bonnes pratiques.

## Articles connexes

- [Du document à la base documentaire modulaire](https://docs.redaction-technique.org/fr/formats/modular-documentation/)
- [Cas concret : documentation de NuFirewall](https://docs.redaction-technique.org/fr/formats/nufirewall-case-study/)
- [Formats et outils](https://docs.redaction-technique.org/fr/costs/formats-and-tools/)

---

Source: https://docs.redaction-technique.org/fr/formats/document-architecture-complexity/