Comment lire ce guide
Avant de plonger dans les axes, 2 minutes pour comprendre les conventions du guide. Ce sont des outils pour t’aider à :
- savoir si tu es prêt pour une page,
- te projeter dans une histoire concrète plutôt qu’apprendre dans le vide,
- comprendre chaque mot technique sans quitter la page.
1. Le badge de niveau
Section intitulée « 1. Le badge de niveau »En haut de chaque sous-section, tu verras un badge comme celui-ci :
Débutant
Trois niveaux possibles :
| Badge | Sens |
|---|---|
| 🌱 Débutant | Lisible si tu as fait les axes précédents — pas de prérequis cachés. |
| 🌿 Confirmé | Suppose un peu de pratique sur les bases (axes 5 à 8 maîtrisés). |
| 🌳 Avancé | Suppose un projet déployé en production ou plusieurs années de pratique. |
Le badge t’indique aussi le temps de lecture estimé ⏱ et les prérequis 📚.
💡 Si tu tombes sur un 🌳 et que tu n’as pas encore les bases, ce n’est pas un échec — c’est juste pas le moment. Reviens plus tard.
2. Le fil rouge — choisis ton parcours
Section intitulée « 2. Le fil rouge — choisis ton parcours »Le guide propose 5 personnages qui chacun construisent un vrai projet à travers les axes 5 à 8. Tu en choisis un et tu le suis. C’est ton repère narratif.
Sur chaque page concernée, en haut :
Clique sur un personnage pour basculer le contenu narratif. Ton choix est mémorisé (localStorage) et tu le retrouves d’une page à l’autre. Tu peux changer à tout moment.
Le bloc d’épisode ressemble à ça :
Bascule entre les onglets ci-dessus pour voir comment l’épisode change selon le parcours.
💡 Tu n’es pas obligé de choisir un parcours. Si tu n’en choisis pas, c’est Marie qui s’affiche par défaut. Tu lis pareil, juste avec son histoire.
📁 Découvre les 5 parcours sur la page /fil-rouge/. Tu y trouveras le détail de chaque personnage, son projet, sa stack, et le tableau de couverture par axe.
3. Le glossaire intégré
Section intitulée « 3. Le glossaire intégré »Dans le texte, certains termes techniques sont soulignés comme ça. Survole-les avec ta souris : une définition courte apparaît. Clique-les : tu atterris sur la page glossaire à l’entrée correspondante.
Exemple : « Une closure en JavaScript est une fonction qui se souvient de son contexte » → survole pour la définition, clique pour le détail dans /glossaire/.
🔗 Page glossaire complète — ~ 80 termes triés alphabétiquement. Tu peux la consulter à tout moment.
4. Les autres conventions du guide
Section intitulée « 4. Les autres conventions du guide »🎯 Objectif au début
Section intitulée « 🎯 Objectif au début »Chaque sous-section commence par une phrase « Objectif » qui dit en clair ce que tu sauras faire après l’avoir lue. Si l’objectif ne te parle pas → tu peux passer.
✅ ObjectiveList
Section intitulée « ✅ ObjectiveList »Liste détaillée des compétences acquises à la fin de la section. À cocher mentalement à la fin pour savoir si tu maîtrises.
Encadrés de plusieurs couleurs :
À la fin de chaque sous-section, des quiz d’auto-évaluation. Réponds avant de regarder l’explication — c’est là que tu détectes si tu as vraiment compris.
🛠 Exercice
Section intitulée « 🛠 Exercice »Les axes ont des exercices avec un dossier canevas/ (squelette à compléter) et correction/ (solution complète). Le code est dans le dossier exercises/ du repo.
5. Si tu es vraiment perdu
Section intitulée « 5. Si tu es vraiment perdu »- Tu ne comprends pas un mot ? → Glossaire ou survole-le.
- Tu ne te souviens plus de ton parcours fil rouge ? → /fil-rouge/.
- Tu ne sais pas par où commencer ? → Préambule puis Axe 1.
- Tu sais déjà coder ? → Saute à l’axe qui te manque, le guide est modulaire après l’axe 4.
Bonne lecture 🌱