4 articles pour 'Outils'

🎬 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 !

Le toolset 2026 du rédacteur technique Docs-as-Code et AI-friendly

À l'ère de l'IA, le docs-as-code n'est plus un choix technique. C'est un choix stratégique.

L'IA progresse à une vitesse impressionnante. Après les agents, les skills et les approches BMAD, une chose devient évidente : l'IA raisonne mieux lorsqu'elle s'appuie sur des structures claires, des données versionnées, des contenus textuels et contextualisés. Autrement dit : sur le terrain naturel du code.

C'est exactement pour cela que la documentation doit désormais être pensée comme du code.

Markdown, Docusaurus & schémas — Mon trio gagnant pour la documentation

Il y a quelque temps, quelqu'un m'a demandé quel outil j'utilisais pour la documentation technique — et au lieu d'en choisir un seul, j'ai réalisé que ma configuration est plutôt un trio créatif.
J'écris en Markdown, je construis avec Docusaurus, et je dessine avec Excalidraw. Dans cet article, je partage pourquoi cette combinaison fonctionne si bien pour moi et comment elle rend l'écriture à la fois simple et puissante.