# Les CMS : le workflow en prime, mais une fiabilité à tester

## Définition

Les CMS (Content Management System), ainsi dénommés pour des raisons purement marketing, mais dont la fonction se comprend mieux avec l'acronyme GED (système de gestion électronique de documents), apportent des notions de workflow et de gestion des liens qui s’avèrent précieuses lorsque l’on gère des documents modulaires.

## Principes clés

S’ils utilisent des formats monolithiques tels que FrameMaker, les rédacteurs techniques peuvent utiliser des CMS tels que SharePoint, Alfresco ou consorts pour :

1. télécharger sur leur disque dur une copie locale des fichiers partagés,
2. effectuer leurs modifications sur la copie locale,
3. déposer la copie modifiée sur le dépôt central.

Cette solution est plus satisfaisante que le partage sur un simple serveur de fichiers, ne serait-ce que parce que la fréquence à laquelle les fichiers transitent sur le réseau est bien moindre. Il est cependant toujours nécessaire de verrouiller les fichiers en cours de modification, ce dont se charge le CMS.

Originellement destinés aux documents monolithiques, de nombreux CMS prennent aujourd’hui en compte la modularisation des documentations techniques. Des solutions telles que DocZone ou Componize, cette dernière bâtie sur Alfresco, sont par exemple explicitement destinées à gérer des documentations modulaires basées sur l’architecture XML DITA XML.

## Compromis

Mais comment croire que ces solutions, qui sont fréquemment disponibles sous de nouvelles versions, marketing oblige, sont toutes d’une fiabilité optimale ?

J’aurais quelques scrupules, et quelques inquiétudes, sur le fait de leur confier entièrement la gestion et l’archivage des fichiers sources de la documentation. Une sélection rigoureuse de la solution s’impose, associée à une procédure de sauvegarde et de restauration éprouvée.

## L'alternative docs-as-code

Avec des formats source texte, un système de gestion de versions apporte l'essentiel de ce que l'on attend d'un workflow de CMS, sans verrouillage de fichiers :

| Ce que l'on attend d'un workflow de CMS | Ce qu'apporte la gestion de versions |
|---|---|
| **Travail en parallèle** | Les branches permettent à plusieurs rédacteurs de travailler en parallèle |
| **Relecture et approbation** | Les pull requests portent les étapes de relecture et d'approbation |
| **Traçabilité** | L'historique enregistre qui a modifié quoi et quand |
| **Archivage** | Chaque clone d'un dépôt Git contient tout son historique, ce qui répond en partie à la question de l'archivage |

Voir [intégrer la documentation aux processus de développement](https://docs.redaction-technique.org/fr/tech-writing-process/integrating-documentation-into-development/) et l'[exemple de workflow de revue](https://docs.redaction-technique.org/fr/toolkit/example-review-workflow/).

Un CMS reste pertinent lorsque les contributeurs ne peuvent pas travailler avec des fichiers texte et un gestionnaire de versions, ou lorsque l'organisation l'utilise déjà pour d'autres contenus.

## Articles connexes

- [Les systèmes de gestion de versions - rustiques mais fiables](https://docs.redaction-technique.org/fr/tech-writing-process/version-control-systems/)
- [Référentiel](https://docs.redaction-technique.org/fr/tech-writing-process/repository/)
- [Git : du fichier au contenu](https://docs.redaction-technique.org/fr/tech-writing-process/git-from-file-to-content/)

---

Source: https://docs.redaction-technique.org/fr/tech-writing-process/cms-workflow-and-reliability/