Ma motivation : réduire le temps entre “je ne sais pas” et “j’ai compris”
Quand j’ai commencé à construire ce site, j’avais un objectif simple : créer la ressource que j’aurais voulu avoir quand j’ai démarré.
Le problème avec la plupart des documentations techniques ? On lit un guide, on croit avoir compris, et deux jours plus tard… on a tout oublié. Ou pire : on se rend compte qu’on avait mal compris un concept clé.
Avec la V3, j’ai posé les fondations : une nouvelle base technique, un glossaire interactif (500+ termes avec tooltips au survol), et une recherche enrichie. C’était bien, mais il manquait quelque chose.
Ce qui manquait : un moyen de valider rapidement ce qu’on a appris, et surtout de comprendre ses erreurs pour les corriger immédiatement.
C’est exactement ce que les versions V3.1 et V3.11 apportent.
Le parcours d’apprentissage que je veux vous offrir
Avant de détailler les nouveautés, laissez-moi vous expliquer la philosophie derrière ces changements.
L’apprentissage efficace suit un cycle :
- Je lis → Je découvre un concept (guide, documentation)
- Je comprends → Le glossaire m’aide à décoder le vocabulaire technique
- Je valide → Un quiz me dit si j’ai vraiment compris
- Je corrige → Si je me trompe, je sais exactement quoi relire
Le problème ? La plupart des sites s’arrêtent à l’étape 1 ou 2. Vous lisez, vous pensez avoir compris, mais vous n’avez aucun moyen de vérifier. Et quand vous faites un quiz ailleurs, il vous dit juste “faux” sans expliquer pourquoi.
Mon objectif avec V3.1 et V3.11 : fluidifier ce cycle complet, surtout les étapes 3 et 4.
V3.1 : naviguer sans friction
La V3.1 s’attaque à un problème concret : on passe trop de temps à chercher au lieu d’apprendre.
Pourquoi j’ai refondu le menu
L’ancien menu avait un défaut classique : il montrait TOUT d’un coup. Résultat :
- Sur mobile, c’était l’enfer (scroll infini)
- On ne savait pas par où commencer
- Les sections importantes étaient noyées dans la masse
La solution : un menu en deux niveaux qui se concentre sur une chose à la fois.
Comment ça fonctionne :
- Le menu Démarrer (en haut) donne accès aux pages essentielles : Learning Path, Examens, Glossaire, Outils
- Le menu Sections affiche une grille d’icônes — cliquez sur une icône, et seule cette section se déplie
Ce que ça change pour vous : vous trouvez ce que vous cherchez en 2-3 clics maximum, au lieu de scroller dans une arborescence géante.
La roadmap devient utile (pas juste jolie)
Une roadmap, c’est censé montrer “par où commencer” et “dans quel ordre apprendre”. Mais si c’est juste une image statique, ça ne sert à rien.
Ce que j’ai changé :
- Cliquez sur un nœud → un panneau s’ouvre avec les détails
- Mode plein écran → indispensable sur mobile/tablette pour zoomer et naviguer
- Zoom et déplacement → vous explorez la carte comme une vraie carte
Ce que ça change pour vous : vous pouvez planifier votre apprentissage en voyant les dépendances entre sujets. “Ah, je dois comprendre X avant d’attaquer Y.”
Les examens sur mobile : enfin utilisables
Avant, faire un quiz sur téléphone était frustrant. Les boutons étaient trop petits, le texte débordait, et le timer cachait la moitié de l’écran.
Ce que j’ai changé :
- Mode plein écran : le quiz prend tout l’écran, sans le menu qui gêne
- Boutons plus grands : conçus pour le tactile
- Navigation par points : vous voyez les questions répondues/non répondues d’un coup d’œil
Ce que ça change pour vous : vous pouvez réviser dans le métro, en pause café, n’importe où.
V3.11 : transformer les erreurs en apprentissage
C’est là que ça devient intéressant. La V3.11 s’attaque au vrai problème : un quiz qui dit “faux” sans expliquer pourquoi, ça n’apprend rien.
Le problème que je voulais résoudre
Imaginez : vous faites un quiz Ansible, vous répondez “le module command” au lieu de “shell”. Le quiz dit “Faux”.
Questions sans réponse :
- Pourquoi c’était faux ?
- Quelle est la différence entre
commandetshell? - Où puis-je relire cette notion ?
Résultat : vous passez 10 minutes à chercher dans la doc, ou pire, vous notez “c’est shell” sans comprendre pourquoi.
Solution 1 : des explications qui enseignent vraiment
Après soumission, chaque question affiche maintenant une explication complète. Pas juste “la bonne réponse était B”, mais une vraie explication pédagogique.
Ce que contiennent les explications :
- Le raisonnement : pourquoi cette réponse et pas une autre
- Du code réel : des exemples que vous pouvez copier et tester
- Des tableaux comparatifs : pour les concepts qu’on confond souvent
- Les pièges classiques : ce que les gens se trompent souvent
Exemple concret : pour une question sur le module stat d’Ansible, l’explication montre :
- name: Vérifier si le fichier existe stat: path: /etc/nginx/nginx.conf register: nginx_conf
- debug: msg: "Taille: {{ nginx_conf.stat.size }} octets" when: nginx_conf.stat.existsPlus un tableau des attributs clés :
| Attribut | Ce qu’il retourne |
|---|---|
stat.exists | true si le fichier existe |
stat.isdir | true si c’est un répertoire |
stat.size | Taille en octets |
Ce que ça change pour vous : vous apprenez de vos erreurs immédiatement, sans quitter le quiz.
Solution 2 : un lien direct vers la doc (pas “cherchez dans le site”)
C’est l’amélioration dont je suis le plus fier.
Après soumission, chaque question a un bouton ”📚 Plus d’infos” qui pointe vers la section exacte de la documentation. Pas la page d’accueil du guide, l’ancre précise.
Pourquoi c’est important :
Avant, si vous vouliez approfondir, vous deviez :
- Aller sur le site
- Trouver le bon guide
- Scroller jusqu’à la bonne section
- Espérer que c’est bien là
Maintenant : un clic, vous êtes au bon endroit.
Ce que ça change pour vous : le temps entre “je me suis trompé” et “j’ai compris pourquoi” passe de 5-10 minutes à 30 secondes.
Solution 3 : un rendu Markdown complet
Pour que les explications soient vraiment utiles, il fallait qu’elles puissent contenir du code, des tableaux, des listes. Pas juste du texte brut.
En coulisses : j’ai remplacé mon parser Markdown maison par marked (une bibliothèque éprouvée). C’est la même que j’utilise pour les FAQ.
Ce que ça permet :
- Des blocs de code avec coloration syntaxique
- Des tableaux bien formatés (comme celui sur
statplus haut) - Des listes à puces et numérotées
- Du texte en gras et italique
Le tout est chargé dynamiquement : pas d’impact sur le temps de chargement de la page.
Comment utiliser ces nouveautés concrètement
Scénario 1 : vous découvrez Ansible
- Activez le glossaire (bouton dans le header)
- Lisez le guide Introduction à Ansible
- Faites le quiz à la fin du guide
- Pour chaque erreur : lisez l’explication, puis cliquez sur “Plus d’infos” pour relire la section
- Refaites le quiz jusqu’à 80%+
Temps estimé : 30-45 minutes pour vraiment maîtriser les bases.
Scénario 2 : vous préparez un entretien technique
- Allez sur la page Examens
- Enchaînez les quiz d’une section (ex: tous les quiz Ansible)
- Notez vos points faibles : les explications vous disent exactement quoi revoir
- Utilisez les liens de référence pour relire uniquement ce qui pose problème
- Recommencez jusqu’à être stable à 80%+
Temps estimé : 2-3 heures pour couvrir une section complète.
Scénario 3 : vous révisez une notion spécifique
- Cherchez avec
Ctrl+K(ex: “ansible loop”) - Lisez la section concernée
- Faites le quiz correspondant
- Vérifiez que vous avez bien compris via les explications
Temps estimé : 15-20 minutes pour une notion ciblée.
Ce qui arrive ensuite
Ces améliorations ne sont qu’une étape. Voici ce que je prépare :
- Roadmaps enrichies : chaque nœud aura ses prérequis, liens vers les guides, et estimation de temps
- Plus d’examens : meilleure couverture par domaine et par niveau (débutant → expert)
- FAQ étendues : plus de questions/réponses en bas de chaque guide
- Parcours guidés : des séquences “lisez ceci, puis ceci, puis validez avec ce quiz”
L’objectif reste le même : réduire le temps entre “je ne sais pas” et “j’ai compris”.
Votre feedback m’aide à améliorer
Si vous observez un bug après mise à jour, faites d’abord un rafraîchissement forcé : Ctrl+Shift+R / Cmd+Shift+R.
Si ça persiste, dites-le moi sur le Discord avec :
- Navigateur + OS (ex: Firefox 120, Ubuntu 22.04)
- Appareil (mobile/desktop/tablette)
- Ce que vous faisiez au moment du bug
Et si vous avez des idées d’amélioration — des sujets manquants, des explications pas claires, des quiz trop faciles/difficiles — je suis preneur. C’est comme ça que le site s’améliore.