Aller au contenu principal

Du besoin à la solution : le plugin coffeecup_tech

· 6 minutes de lecture
Florence Venisse
Florence Venisse
Rédactrice Technique Expert

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

Voir

"Données structurées : du Root.js manuel au plugin JSON-LD"

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.

Données structurées : du Root.js manuel au plugin JSON-LD

· 7 minutes de lecture
Florence Venisse
Florence Venisse
Rédactrice Technique Expert

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 !

J'ai pris le contrôle de mes métadonnées

· 9 minutes de lecture
Florence Venisse
Florence Venisse
Rédactrice Technique Expert

Comment j'ai agis sur les données structurées pour contrôler mon identité numérique

À l'ère où tout est data — nos photos, nos documents, nos publications, nos sites — les métadonnées sont devenues un enjeu stratégique majeur.
Les moteurs de recherche, les moteurs génératifs, les ATS, les plateformes de Freelancing, les IA... tous lisent ces métadonnées avant même de lire le contenu.

Les métadonnées influencent donc la manière dont les moteurs de recherche, les moteurs génératifs, les ATS, les IA et même les outils internes interprètent vos contenus.
Elles deviennent une sorte de carte d'identité numérique, un passeport sémantique.

Contrairement à un PDF* ou à une base de connaissances figée, un site Web offre un avantage décisif : on peut y écrire soi‑même ses métadonnées et donc, les contrôler.

Mon toolset pour 2026

· 4 minutes de lecture
Florence Venisse
Florence Venisse
Rédactrice Technique Expert

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.

Comment j'ai fait le SEO de mon site

· 6 minutes de lecture
Florence Venisse
Florence Venisse
Rédactrice Technique Expert

Mettre en œuvre un SEO concret sur un site Docusaurus, avec le GEO en ligne de mire

Le SEO fait partie de ces sujets dont tout le monde parle, mais que peu de personnes pratiquent réellement de bout en bout sur un vrai site. C'est un véritable métier, avec de vraies compétences, et certainement pas quelque chose que l'on improvise en se contentant de bourrer le <head> de mots-clés.

Lorsque j'ai construit CoffeeCup.tech, je ne voulais pas que le SEO reste une simple checklist théorique (contrairement à ce que j'ai pu faire pour mon précédent site Hugo Coffee Cup, je l'avoue).

Mon parcours d'IA – Épisode 2️⃣

· 4 minutes de lecture
Florence Venisse
Florence Venisse
Rédactrice Technique Expert

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.

Mon parcours d'IA – Épisode 1️⃣

· 2 minutes de lecture
Florence Venisse
Florence Venisse
Rédactrice Technique Expert

De la théorie à la réalité

Ces derniers mois, je me suis plongée dans le monde fascinant de l'intelligence artificielle. Une exploration joyeuse et concrète de l'IA au service de la créativité numérique : une refonte complète de mon site web, portée par Docusaurus, l'IA générative, mon expertise et ma passion comme moteur.

Je me forme à l'IA

· 2 minutes de lecture
Florence Venisse
Florence Venisse
Rédactrice Technique Expert

Mettre l'IA au service de la rédaction technique

Je me forme à l'intelligence artificielle. Pas pour suivre une mode. Mais pour comprendre ce qu'elle peut réellement apporter à mon métier.
Avec une solide expérience dans la création et la maintenance de sites de documentation, je souhaite aller plus loin en comprenant les modèles d'IA, en testant les outils et en apprenant à les utiliser avec discernement. L'IA offre en effet de nombreuses possibilités...

Je n'ai jamais cessé d'apprendre

· 2 minutes de lecture
Florence Venisse
Florence Venisse
Rédactrice Technique Expert

La quête continue du savoir et des compétences

Je suis ce qu'on appelle une "apprenante perpétuelle".
Apprendre tout au long de la vie, et pas seulement pendant les études, présente de nombreux avantages clés : rester à jour, gagner en confiance, stimuler la créativité et trouver un sens plus profond dans son travail. Obtenir un diplôme ne marque pas la fin de l'apprentissage, et les connaissances acquises à l'école ne suffisent pas pour une carrière complète.

Mes outils favoris

· 5 minutes de lecture
CoffeeCup
CoffeeCup
Rédactrice Technique Senior

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.