4 articles pour 'Productivité'

🎬 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 temps des travaux pratiques

Après avoir collecté tout ce que je pouvais sur l'intelligence artificielle (Épisode 1), élaboré des cas d'usages pour mon métier, j'ai décidé de passer de la théorie à la pratique en retravaillant entièrement mon site Web.

Objectif : appliquer mes nouvelles connaissances et tester, en conditions réelles, ce qu'une IA peut vraiment apporter à un professionnel du contenu.

La méthode Docs-as-Code : une philosophie pour une meilleure documentation

Pendant des années, la documentation n'arrivait qu'après le développement. La méthode consistait à collecter des informations — parfois directement auprès des développeurs, mais le plus souvent dans notre propre bulle, entre rédacteurs techniques. Puis un jour, j'ai réalisé quelque chose : j'utilisais Git, j'écrivais en Markdown, je poussais des commits, j'éditais dans VS Code. Attends une minute — je faisais du docs-as-code.