La V3 de blog.stephane-robert.info est en ligne !!!
Mais avant de parler de ce qui change, je voulais revenir sur le chemin parcouru. Parce que cette V3 n’est pas arrivée par hasard : elle est le résultat de six années d’apprentissage, d’erreurs, et de choix techniques assumés.
Un peu d’histoire : Hugo, Docusaurus, Astro
Hugo : le point de départ
Quand j’ai lancé ce site ne 2019, j’ai commencé avec Hugo. C’était rapide, simple, et ça faisait le job pour publier du Markdown. Mais au bout de quelques mois, j’ai ressenti une frustration : je voulais faire plus. Des composants interactifs, une meilleure gestion des collections de contenu, des fonctionnalités “produit” (quiz, glossaire, parcours d’apprentissage).
Hugo, à l’époque, n’était pas fait pour ça. Ou alors, il fallait tordre le système dans tous les sens. J’ai donc cherché autre chose.
Docusaurus : la promesse React
Je suis passé à Docusaurus. L’écosystème React, les plugins, la communauté… sur le papier, c’était parfait. Et pendant un an, ça a bien fonctionné.
Puis Google a déployé les Core Web Vitals. Et là, catastrophe.
Les performances étaient mauvaises. Le bundle JavaScript était trop lourd. Les scores Lighthouse dégringolaient. J’ai passé des semaines à optimiser, à chercher des contournements… mais le problème était structurel. Docusaurus, avec son approche “React partout”, n’était pas conçu pour générer des pages statiques ultra-légères.
Il fallait changer de crémerie.
Astro V4 : la révélation (puis le piège)
J’ai découvert Astro. Et là, c’était exactement ce que je cherchais : du contenu statique par défaut, du JavaScript uniquement quand c’est nécessaire, et une flexibilité totale sur les composants.
J’ai reconstruit le site en Astro V4. Les performances étaient excellentes. Les Core Web Vitals au vert. J’étais content.
Mais j’ai fait une erreur : j’ai utilisé trop de composants tiers. Des plugins pour ci, des extensions pour ça. Le site marchait, mais je ne maîtrisais plus vraiment ce qui se passait sous le capot. Et quand j’ai voulu ajouter des fonctionnalités (un vrai glossaire, des quiz intégrés), je me suis retrouvé bloqué par des dépendances que je ne contrôlais pas.
Astro V5 : tout recoder, tout maîtriser
Avec l’annonce de la V6 d’Astro à l’horizon, je me suis dit : c’est le moment. Soit je continue à empiler des rustines, soit je repars sur des bases saines.
J’ai choisi la deuxième option.
J’ai gardé uniquement le contenu Markdown. Et j’ai tout recodé : les composants, les layouts, les scripts de génération. Plus aucune extension tierce. Tout est fait maison.
C’est plus de travail au départ. Mais maintenant, je maîtrise chaque ligne de code. Et surtout, je peux enfin ajouter les fonctionnalités que j’avais en tête depuis longtemps.
La release d’Astro 5.0 (décembre 2024) apportait exactement ce dont j’avais besoin : le Content Layer pour gérer le contenu de manière flexible, les Server Islands pour les composants dynamiques, et une base plus solide pour construire des fonctionnalités “produit”.
Ce qui change dans cette V3
Un glossaire qui sert vraiment
Le vocabulaire DevSecOps est dense. Quand on lit un guide, on tombe régulièrement sur des termes qu’on ne maîtrise pas. Avant, il fallait ouvrir un nouvel onglet, chercher, revenir… friction maximale.
Maintenant, les termes du glossaire sont intégrés directement dans les articles. Vous les repérez grâce à un soulignement pointillé. Au survol, une infobulle affiche la définition courte. En cliquant, vous accédez à la définition complète.
Et si les tooltips vous gênent (parce que vous connaissez déjà le vocabulaire), vous pouvez les désactiver via un bouton dans le header.
Le glossaire compte aujourd’hui plus de 780 termes. C’est devenu un vrai outil de référence, pas juste une page statique qu’on consulte une fois.
Des quiz pour valider ses connaissances
J’ai refait entièrement le système d’examens. À la fin de nombreux guides, vous trouverez un quiz interactif pour tester ce que vous avez retenu.
Trois types de questions :
- QCM : choix multiples avec une seule bonne réponse
- Vrai/Faux : affirmations à valider ou infirmer
- Mot à trouver : terme technique à saisir
Chaque question est accompagnée d’une explication détaillée. L’objectif n’est pas de vous piéger, mais de vous aider à identifier ce qui est acquis et ce qui mérite d’être revu.
Une page dédiée aux examens regroupe tous les quiz disponibles, classés par domaine. De nouveaux examens arriveront bientôt — mais avant d’en ajouter, je dois intégrer des liens vers les guides de référence pour chaque question. L’idée : si vous vous trompez, vous pouvez directement aller relire la section concernée.
Des FAQ par domaine
Les guides longs incluent désormais une section FAQ en fin de page. Ces questions-réponses couvrent les interrogations fréquentes, les cas particuliers, et les pièges courants.
Les FAQ sont structurées par domaine (Linux, Docker, Ansible, Kubernetes…) et prêtes pour les données structurées schema.org.
Une recherche qui fonctionne
Le site dispose d’une recherche full-text accessible via Ctrl+K (ou Cmd+K sur Mac). Elle indexe les titres, les descriptions, le contenu intégral des guides, et les termes du glossaire.
SEO préservé
Un point non négociable : la migration ne devait pas casser le référencement.
- 876 URLs conservées à l’identique
- 33 redirections 301 pour les URLs qui ont changé
- Sitemaps segmentés (
sitemap-content.xml,sitemap-news.xml)
Comment tirer le meilleur parti du site
Si vous débutez
- Activez le glossaire (bouton dans le header)
- Commencez par les fondamentaux DevOps
- Faites les quiz pour ancrer les concepts
- Utilisez les tooltips pour comprendre les termes au fil de la lecture
Si vous cherchez une info précise
- Désactivez le glossaire pour une lecture fluide
- Utilisez la recherche (
Ctrl+K) - Naviguez via la table des matières (colonne de droite)
Si vous révisez pour un entretien ou une certif
- Parcourez les quiz des sections concernées
- Consultez le glossaire pour le vocabulaire technique
- Relisez les encadrés (tip, caution, danger) qui résument les points essentiels
Et maintenant ?
Cette V3 est un socle, pas une fin.
Refonte de l’organisation du site
Le gros chantier en cours : remettre à plat la structure de la documentation. L’idée : les concepts avant la pratique.
| Avant | Après |
|---|---|
/docs/fondamentaux/ | /docs/devops/ |
/docs/documenter/ | /docs/devops/fondamentaux/documenter/ |
| Structure plate | Hiérarchie DevSecOps logique |
Et surtout : la sécurité ne sera plus un “bloc isolé”. Elle sera intégrée dans chaque section (conteneurs, CI/CD, IaC, Kubernetes…), parce que c’est comme ça qu’on l’applique réellement.
Pourquoi ce n’est pas livré avec la V3 ? Honnêtement, je me suis enfoncé dans l’effet tunnel. Je voulais tout restructurer avant de publier, mais je n’étais jamais satisfait. Chaque amélioration en appelait une autre. Au bout d’un moment, j’ai compris que si j’attendais que ce soit “parfait”, je ne livrerais jamais.
Donc la V3 sort maintenant, avec le socle technique en place. La section DevOps affiche une bannière qui indique que le contenu est en cours de refonte. Vous pouvez déjà lire les guides existants — ils fonctionnent — mais la structure va évoluer dans les semaines qui viennent.
C’est aussi une façon de m’engager publiquement : maintenant que c’est annoncé, je suis obligé de finir.
Autres chantiers
- Enrichir les examens (plus de domaines, plus de niveaux)
- Enrichir le glossaire (plus de termes, définitions plus complètes)
- Enrichir les FAQ (plus de questions, contributions des lecteurs)
- Améliorer le design qui n’est pas parfait (je suis développeur, pas designer)
- Ajouter un examen complet sur le DevSecOps
- A plus long terme, ajouter des parcours d’apprentissage visuels (roadmaps)
Si vous explorez le site et que vous repérez un point perfectible (lien cassé, structure confuse, fonctionnalité manquante), c’est exactement le moment où les retours sont les plus utiles. Rejoignez le Discord pour échanger.