CoffeeCup.tech
Consultante documentation technique & IA — Site Web AI-ready, SEO/GEO
Éléments clés
| Catégorie | Données |
|---|---|
| Organisation | CoffeeCup.tech |
| Période | De mai 2025 à mars 2026 |
| Type de projet | Refonte stratégique d'un site Web bilingue |
| Rôle | Consultante en Documentation Technique & IA |
| Périmètre | Positionnement, architecture de l'information, contenus, SEO/GEO et conception AI-ready |
| Publics | Prospects, recruteurs, rédacteurs techniques, équipes Produit et R&D |
| Langues | Français et anglais |
| Environnement | Docusaurus, Markdown, Git, CI/CD, workflows assistés par l'IA |
Présentation du projet
CoffeeCup.tech est mon site professionnel et la principale plateforme sur laquelle je présente mon expertise en documentation technique, mes services de conseil, mon portfolio clients et mes réflexions sur l'avenir de la documentation.
J'ai entièrement repensé le site bilingue anglais-français afin de refléter l'évolution de mon positionnement vers la stratégie documentaire, l'architecture documentaire, le docs-as-code, la documentation API, le knowledge management et l'IA appliquée aux contenus techniques.
Bien qu'il s'agisse d'un projet interne réalisé pour ma propre activité, je l'ai abordé avec le même niveau d'analyse, de structuration, de test et d'exigence documentaire que mes missions clients.
Contexte
La version précédente de CoffeeCup.tech ne reflétait plus pleinement l'évolution de mon expertise ni la place croissante de l'architecture documentaire, du docs-as-code, du knowledge management et de l'IA dans mon travail.
Le projet est donc allé bien au-delà d'une refonte visuelle. Il a nécessité une révision complète du positionnement du site, de son architecture de l'information, de sa navigation, de la hiérarchie des contenus, de sa structure multilingue, de ses métadonnées et de sa visibilité dans les moteurs de recherche.
L'objectif était de créer un site de documentation professionnel capable de :
- présenter clairement mes services et mon expérience ;
- proposer des parcours adaptés à différents publics, notamment les prospects et les recruteurs ;
- mettre en valeur une sélection de projets et des études de cas détaillées ;
- publier des contenus de fond sur la documentation technique et l'IA ;
- améliorer le SEO et la visibilité dans les environnements de recherche générative ;
- fournir une source de contenus structurée et fiable, exploitable à la fois par les visiteurs humains et les systèmes d'IA.
Principaux livrables
Stratégie du site, plateforme documentaire et identité visuelle
J'ai entièrement repensé CoffeeCup.tech afin d'aligner le site sur mon positionnement actuel en stratégie documentaire, docs-as-code, documentation API, knowledge management et contenus AI-ready.
La refonte a porté non seulement sur la structure et le discours du site, mais également sur son identité visuelle. J'ai développé un nouveau thème graphique et utilisé des outils de génération d'images pour explorer et affiner plusieurs concepts visuels, notamment le logo, la mascotte et les illustrations associées. L'objectif était de créer une identité distinctive, tout en restant professionnelle, cohérente et étroitement liée à la marque CoffeeCup.tech.
J'ai également migré le site de Hugo vers Docusaurus. Docusaurus est mon framework favori pour les sites de documentation, et ce projet m'a permis de l'étudier plus en profondeur dans le cadre d'une refonte réelle. J'ai travaillé sur la navigation, les composants réutilisables, les contenus bilingues, la taxonomie, les métadonnées, le thème ainsi que des éléments React et CSS personnalisés.
L'architecture résultante a été conçue pour :
- clarifier le positionnement et les services ;
- proposer des parcours distincts aux clients, recruteurs et professionnels de la documentation ;
- structurer de manière cohérente le portfolio, le profil, les services et les contenus éditoriaux ;
- améliorer la navigation multilingue, la découvrabilité et la maintenabilité à long terme.
Ce travail a transformé le site à la fois en vitrine professionnelle et en exemple concret de plateforme documentaire moderne fondée sur le docs-as-code.
Docs-as-data, SEO et GEO
Une part importante de la refonte a consisté à considérer le site non plus seulement comme un ensemble de pages, mais comme un corpus de données structuré et réutilisable.
J'ai analysé la manière dont les contenus, les métadonnées, la terminologie, la hiérarchie, les liens internes et les données structurées du site pouvaient être interprétés à la fois par les moteurs de recherche et par les systèmes d'IA générative. L'objectif était de rendre le site plus facile à trouver, à comprendre et à citer, tout en préservant une expérience claire et utile pour les lecteurs humains.
Ce travail a notamment consisté à :
- aligner la structure des contenus, la terminologie et les expressions clés sur les requêtes humaines et celles adressées aux systèmes d'IA ;
- renforcer les métadonnées, les signaux d'autorité, les liens internes et la cohérence sémantique ;
- définir des données structurées pour les pages, les articles, les services et l'identité professionnelle ;
- utiliser le front matter comme source unique de vérité pour les métadonnées multilingues et la génération de JSON-LD.
Le projet est ainsi devenu une mise en pratique concrète de mon approche « docs-as-data » : la documentation n'est pas seulement un contenu destiné à être lu, mais un actif de connaissances gouverné et maintenable, pouvant être indexé, retrouvé, réutilisé et interprété par les moteurs de recherche, les systèmes RAG et les IA génératives.
Les outils d'IA ont été utilisés de manière sélective pour challenger certaines formulations, comparer des alternatives et soutenir des tâches de révision ou de localisation. L'orientation stratégique, le modèle de contenu, l'architecture des métadonnées, les choix éditoriaux et la validation finale sont restés sous ma responsabilité.
Mon rôle
J'ai piloté le projet de bout en bout, en combinant stratégie documentaire, architecture de l'information, contenus multilingues, SEO/GEO et mise en œuvre d'un site de documentation.
Travaillant de manière indépendante, j'ai utilisé l'IA de façon sélective comme partenaire de réflexion afin de challenger mes idées et d'explorer différentes options, tout en conservant l'entière responsabilité de la stratégie, de l'exactitude des contenus et des décisions finales.
Technologies et outils
Docusaurus, Markdown, Git, GitHub, CI/CD, Visual Studio Code, React, CSS, JavaScript, ChatGPT, Claude, Copilot, Le Chat, Google AI, DeepL, Grammarly, Microsoft Designer, Google AI Imagen, Bing Image Creator, Canva, Mermaid et Excalidraw.
Projet public
CoffeeCup.tech est un projet public en ligne qui continue d'évoluer à mesure que j'affine mon positionnement, publie de nouveaux exemples de portfolio et explore les pratiques émergentes en documentation technique et en IA.
© Florence Venisse, Experte en Documentation Technique & IA – Version révisée le 21/07/2026.