Qu'est-ce qu'une source unique (Single Source of Truth) en documentation technique ?

Qu'est-ce qu'une source unique (Single Source of Truth) en documentation technique ?

La source unique ou Single Source of Truth (SSOT) est le principe fondamental de la rédaction structurée en documentation technique : chaque contenu est rédigé une seule fois, stocké à un seul endroit, puis réutilisé par référence dans tous les documents qui en ont besoin. Quand la source est modifiée, la mise à jour se propage automatiquement dans l'ensemble du corpus documentaire. Ce principe s'oppose directement au copier-coller pratiqué dans Word ou InDesign, et constitue le socle de tout CCMS (Component Content Management System) comme Calenco.

Le principe de la source unique expliqué simplement

En documentation technique, un même contenu revient dans de nombreux documents. Un avertissement de sécurité, une procédure de maintenance, une spécification technique, une mention légale : ces éléments apparaissent dans des notices, des manuels, des fiches produits, des supports de formation.

La question est de savoir comment cette information est stockée. Deux approches existent, et elles produisent des résultats radicalement différents.

L'approche traditionnelle par duplication

Dans l'approche traditionnelle (Word, Google Docs...), chaque document contient sa propre copie de l'information. Le rédacteur écrit l'avertissement de sécurité dans le manuel A, puis le copie dans le manuel B, puis dans la fiche produit C. Trois documents, trois copies, trois emplacements différents.

L'approche par Single Source of Truth

Dans l'approche par source unique, l'avertissement n'existe qu'en un seul exemplaire, stocké dans la plateforme. Les documents ne contiennent pas de copies : ils contiennent des références vers ce contenu unique. Trois documents, une seule source.

L'image la plus parlante est celle d'un objet placé devant plusieurs miroirs : modifiez l'objet, tous les reflets changent instantanément. Il n'y a jamais à corriger chaque reflet séparément.

Pourquoi le copier-coller pose un problème structurel

Le copier-coller n'est pas seulement une pratique inefficace, il crée un problème structurel de cohérence de l'information, qui s'aggrave avec le volume documentaire.

La multiplication des opérations manuelles

Quand une information est dupliquée en dix exemplaires, sa mise à jour impose dix opérations manuelles. Il faut identifier tous les documents concernés, les ouvrir un par un, localiser le passage, le corriger, sauvegarder, republier. Chaque étape est une occasion d'erreur ou d'oubli.

L'apparition de versions divergentes

La conséquence directe est l'apparition de versions divergentes. Un document a été mis à jour, un autre non. Deux notices du même produit affichent deux valeurs différentes pour la même spécification. Personne ne sait laquelle fait foi.

Dans les secteurs soumis à des exigences réglementaires, industrie, énergie, santé, cette divergence n'est pas un simple inconfort. C'est un risque de conformité, et potentiellement un risque de sécurité.

Le travail de mise à jour manuel absorbe par ailleurs un temps considérable, qui n'apporte aucune valeur ajoutée : il ne s'agit pas de produire du contenu, mais de répliquer une correction déjà effectuée ailleurs.

Comment la Single Source of Truth fonctionne dans un CCMS

Dans un CCMS (Component Content Management System), la source unique n'est pas une méthode de travail ni une bonne pratique à respecter : c'est une réalité technique imposée par l'architecture de l'outil.

Le découpage en composants réutilisables

Le contenu est découpé en composants réutilisables. Un composant peut être un paragraphe, un avertissement, une procédure, une image, un tableau. Dans Calenco, le niveau de granularité est très fin : il est possible de créer un contenu réutilisable correspondant à un seul mot.

Chaque composant est stocké une seule fois, avec un identifiant propre dans une bibliothèque de contenu réutilisable. Quand un rédacteur crée un document, il assemble des modules existants à partir de cette bibliothèque. Le document final est un assemblage de références, pas une accumulation de texte dupliqué.

La propagation automatique des mises à jour

Lorsqu'un module source est modifié, tous les documents qui l'utilisent se régénèrent automatiquement. La mise à jour d'un corpus documentaire entier se fait à partir d'une seule opération, quels que soient le nombre de documents concernés, leur langue et leur format de publication.

Source unique et publication multi-format

La source unique produit son plein effet lorsqu'elle est associée à la séparation du fond et de la forme.

Dans Calenco, le rédacteur se concentre uniquement sur le contenu rédactionnel. La mise en page est appliquée automatiquement par une feuille de style au moment de la publication, selon le format de sortie choisi et la charte graphique de l'entreprise.

Depuis une seule source unique, le même document peut être publié en PDF basse et haute résolution, en HTML, en WebHelp, en ePub, ou diffusé sur tablette et smartphone. Le contenu n'a pas besoin d'être réadapté manuellement.

Sans source unique, chaque format supposerait sa propre version du contenu, donc ses propres copies, donc ses propres risques de divergence. La séparation du fond et de la forme n'est possible que parce que le contenu existe indépendamment de sa présentation.

Source unique et gestion multilingue

Le multilingue est le cas où la Single Source of Truth produit les gains les plus mesurables.

Quand une documentation existe en vingt langues et que chaque langue est gérée dans des fichiers séparés, la modification d'un contenu source impose vingt interventions, chacune avec son propre risque d'oubli.

La synchronisation des traductions

Avec une source unique, la modification est faite une fois. Calenco compare ensuite la source modifiée avec sa dernière version linguistique afin d'identifier précisément ce qui doit être retraduit. Les traductions restent synchronisées avec les contenus d'origine.

Calenco dispose d'un connecteur vers des outils TAO (Traduction Assistée par Ordinateur) dotés d'une mémoire de traduction, et s'intègre avec Phrase, plateforme de gestion linguistique. La mise en page de chaque version linguistique est appliquée automatiquement par les feuilles de style, sans intervention du traducteur sur la présentation.

Pellenc publie ses notices techniques dans vingt langues avec Calenco, et a réduit ses coûts de traduction de 60 % après avoir abandonné InDesign.

Ce que la Single Source of Truth change concrètement

Les effets de la source unique se mesurent sur quatre plans.

La cohérence

Une information n'existant qu'en un exemplaire, il devient impossible que deux documents affichent deux valeurs contradictoires pour la même donnée.

La fiabilité

Les erreurs liées au copier-coller disparaissent, ainsi que les versions obsolètes laissées en circulation après une mise à jour incomplète.

Le temps

La mise à jour d'un corpus documentaire complet se fait à partir d'une seule modification. Pellenc a réduit ses temps de rédaction de 50 % en passant de Word à Calenco.

La conformité

Dans les secteurs réglementés, la traçabilité de l'information et la certitude qu'un document publié reflète l'état à jour de la source sont des exigences, pas des améliorations optionnelles.

La Single Source of Truth dans Calenco

Calenco est un CCMS français, édité par NeoDoc, société spécialisée en ingénierie documentaire créée en 2004 et basée près d'Aix-en-Provence.

La plateforme applique le principe de la source unique sur l'ensemble du cycle documentaire : chaque module de contenu est stocké une seule fois dans une bibliothèque, réutilisable dans plusieurs documents, et mis à jour en un seul endroit pour tous les formats de publication.

Calenco repose sur les standards ouverts internationaux XML et DocBook, ce qui garantit la pérennité des données et l'interopérabilité avec les systèmes existants, sans dépendance à un format propriétaire.

Cas d'usage

Des organisations comme EDF, SNCF, Thales, ou Pellenc utilisent Calenco pour produire et maintenir leur documentation technique.

Til Technologies a restructuré son corpus documentaire en identifiant les contenus communs entre documentation technique et supports de formation, puis en les transformant en modules réutilisables.

En résumé

La source unique, ou Single Source of Truth, consiste à ne stocker chaque information qu'une seule fois et à la réutiliser par référence dans tous les documents concernés. Elle supprime les copies, donc les divergences, donc les mises à jour manuelles répétées.

C'est le principe fondateur de la rédaction structurée et le mécanisme central de tout CCMS. Dans Calenco, il s'applique à l'ensemble du corpus documentaire, quels que soient le nombre de documents, de langues et de formats de publication.