Journal d’un rédacteur technique qui a sauté le pas

Pourquoi passer au standard DITA XML ?

Pourquoi passer au standard DITA XML ? | Témoignage d’un rédacteur technique

Pourquoi passer au standard DITA XML ?

Journal d’un rédacteur technique qui, au fil du projet, a vu son écriture se transformer — jusqu’à devenir du DITA XML.

Mes premiers pas dans la rédaction technique

Je n’ai pas commencé ma carrière en rêvant d’écrire du XML. Comme beaucoup, j’alternais documents Word, gabarits InDesign, PDF toujours en retard sur la réalité terrain. Je passais plus de temps à réconcilier des versions qu’à aider l’utilisateur final.

Un jour, un chef de projet me parle de DITA XML. À l’époque, je trouvais l’idée austère. Pourtant, la promesse me travaillait : réutilisation, cohérence, publication multicanale. Et si la rédaction technique DITA me libérait enfin du “copier-coller perpétuel” ?

La machine qui m’a fait basculer

Le déclic vient d’une machine industrielle : variantes multiples, options, procédures de sécurité, maintenance… Une notice par modèle devenait ingérable. On me confie un pilote DITA : découper en concepts, procédures, références, puis assembler.

–40 %
Temps de mise à jour des contenus communs

–25 %
Coûts de traduction grâce aux segments réutilisés

+100 %
Cohérence perçue entre guides (audit interne)

Je découvre que je n’écris plus un document : je construis un système d’information qui alimente PDF, HTML et aide embarquée.

Ce que DITA a changé dans mon quotidien

Réutiliser au lieu de dupliquer

Une procédure d’arrêt d’urgence commune à 7 modèles ? Un seul topic partagé. Une correction, et tout le fond se met à jour.

Traduire plus sereinement

Les fichiers structurés deviennent des segments clairs pour la TAO. Les répétitions sont identifiées, les coûts baissent, la qualité monte.

Publier en multicanal, sans sueur froide

Avec le moteur de conversion DITA Open Toolkit, je génère PDF, HTML, portail, depuis une source unique. Une charte évolue ? Je republie, au lieu de tout refaire.

Le moment où mon écriture a commencé à muter

À force de structurer, ma pensée s’est structurée. Naturellement, j’ai commencé à glisser des repères “sémantiques” dans mes phrases. Sans m’en apercevoir, j’introduisais les briques DITA dans ma narration.

```

Au début, de simples indices : <concept>, <task>, <reference>. Puis j’ai assumé la transformation.

« Je n’étais plus un rédacteur de manuels, mais un architecte de contenu. »

```

<concept id="pourquoi-dita">Pourquoi DITA a changé ma manière d’écrire</concept>

<shortdesc>Chaque paragraphe a un type. La nommer accélère tout : révision, traduction, publication.</shortdesc>

<body>Je distingue désormais ce qui explique d’un guide pas-à-pas. Et je relie au lieu de dupliquer.</body>

```

<task id="arret-urgence">Procédure d’arrêt d’urgence (extrait)</task>

Note : Ci-dessous, la tâche est volontairement abrégée pour la lisibilité d’un article.

<task id="task-arret-urgence">
```

Arrêt d’urgence de la machine
Procédure standard valable pour les modèles A, B, C.


Appuyez sur le bouton rouge STOP.
Coupez l’alimentation principale.
Signalez l’arrêt au superviseur.

La machine s’arrête et passe en mode sécurisé.
Consignez l’incident dans le registre de maintenance.

```

<reference id="specs-bouton-stop">Référence : Spécifications du bouton STOP</reference>

<reference id="ref-stop">
```

Bouton STOP — caractéristiques



Couleur
Rouge RAL 3020
Norme
EN ISO 13850
Type
à accrochage

```

<map>Assembler sans dupliquer : ma première map</map>

<map id="guide-utilisation">
```

Guide d’utilisation — Série X

```

Astuce : j’ai cessé de chercher “où recoller un paragraphe”. Je relie des unités d’information cohérentes. <xref href="tasks/task-arret-urgence.dita">La preuve.</xref>

```

Et soudain, mon billet est devenu un document DITA

<topic id="temoignage-dita">
  <title>Mais pourquoi devrait-on passer à DITA XML ? — Témoignage</title>
  <shortdesc>Récit d’un rédacteur technique qui passe progressivement d’une écriture libre à une écriture structurée DITA.</shortdesc>
  <body>
    <section>
      <title>Avant DITA</title>
      <p>Versions multiples, duplication, délais. Le quotidien du copier-coller.</p>
    </section>
    <section>
      <title>Déclic</title>
      <p>Structurer m’a aidé à mieux penser et à mieux publier.</p>
    </section>
    <section conref="tasks/task-arret-urgence.dita#task-arret-urgence/shortdesc"></section>
    <section>
      <title>Conclusion</title>
      <p>On n’écrit plus seulement des documents ; on modélise la connaissance.</p>
    </section>
  </body>
</topic>

Ma conclusion de rédacteur

La rédaction technique DITA m’a appris à penser en unités d’information reliées. J’écris moins ; j’assemble mieux. Et chaque jour, je gagne en cohérence, en vitesse et en sérénité.

Essayez DITA XML. Vous n’adopterez pas seulement un format : vous changerez votre méthode de rédaction.