3 articles pour 'Documentation strategy'

Comment j'ai transformé une stratégie documentaire en conception d'agents

J'ai récemment eu l'occasion de passer de la réflexion sur l'IA appliquée à la documentation à la conception concrète d'agents documentaires.

Le contexte était une vaste base de connaissances Confluence couvrant de la documentation technique et produit autour du Marketing Mix Modeling (MMM). Ses utilisateurs comprenaient des Data Scientists, des Data Engineers et des consultants travaillant sur les domaines Data, Modeling, Insights et Simulations.

Comme cela m'arrive souvent dans mes missions freelance, j'arrivais dans un domaine que je ne connaissais pas encore. Avant de penser à l'IA, j'ai d'abord dû comprendre le domaine métier, l'écosystème documentaire, ses auteurs et ses utilisateurs.

Cela fait partie du métier.

🎬 Précédemment, dans l'épisode 1...

Dans la partie 1, j'expliquais pourquoi les approches classiques pour gérer les données structurées dans Docusaurus finissaient par montrer leurs limites : duplication, maintenance fragile, multilingue compliqué.

Même avec de bonnes pratiques comme @graph, le problème de fond restait entier : les données structurées vivaient à côté du contenu, au lieu d'en être une extension naturelle.

Dans cette partie 2, on passe du constat à la solution.

Je vais vous montrer comment cette réflexion m'a menée à concevoir un plugin pour Docusaurus, pensé dès le départ pour :

• s'appuyer sur les front matter comme source de vérité,
• générer automatiquement du JSON-LD conforme à schema.org,
• gérer le multilingue proprement,
• et rester maintenable dans le temps.

Comment mon travail sur les données structurées a fini en plugin Docusaurus

Dans mon article précédent, "J'ai pris le contrôle de mes métadonnées", j'expliquais comment j'avais exploré deux méthodes pour injecter des données structurées dans Docusaurus.

Ce travail m'a amenée à une conclusion simple : pour un site bilingue, riche en contenu, et pensé pour le SEO moderne (SEO, GEO et moteurs génératifs compris), aucune des méthodes existantes n'était satisfaisante sur la durée.

À ce stade, j'avais le choix : accepter la complexité croissante... ou changer complètement d'approche.
C'est ainsi qu'est née la troisième méthode, puis un plugin !