Les bases SQL comme référentiel documentaire
Dans un CMS comme Drupal, Joomla ou WordPress, le contenu documentaire est stocké en base SQL, qui ne conserve qu'un historique article par article et interdit la recherche-remplacement globale - d'où l'intérêt de le gérer en fichiers texte.
Définition
Section intitulée « Définition »Dans le cas d’un CMS de type Drupal, Joomla ou WordPress, le RéférentielL'endroit où une équipe documentaire conserve ses sources : répertoires partagés, base de données d'un CMS ou système de gestion de versions comme Git, qui conserve en outre l'historique complet de chaque fichier. Un référentiel Git est aussi appelé dépôt.Voir dans le glossaire → est une base de données SQL. Il conserve un historique, mais uniquement article par article et ne permet pas la recherche et le remplacement de texte à travers tout le contenu.
Compromis
Section intitulée « Compromis »Cela peut justifier le choix de gérer le contenu sous-jacent du CMS (Content Management System)Un outil qui ajoute workflow et verrouillage des fichiers à la gestion de contenu, au prix de compromis de fiabilité par rapport à une gestion de versions simple.Voir dans le glossaire → sous forme de fichiers texte. C’est le fonctionnement des générateurs de sites statiques : le contenu est stocké sous forme de fichiers texte dans un dépôt Git, le site publié est un produit de la génération, et la recherche-remplacement sur l’ensemble du contenu devient une opération ordinaire sur des fichiers.
Une base de données comme source de données
Section intitulée « Une base de données comme source de données »Une base de données peut toutefois rester la bonne source de données pour la documentation (noms et versions de produits, par exemple), tant que le texte lui-même reste dans des fichiers. Pour un exemple d’interrogation d’une base SQL alimentant automatiquement la documentation, voir insérer automatiquement des données SQL dans un fichier reStructuredText.