Tu lis un tuto et soudain : "Fais un commit, push sur ta branch, puis ouvre une PR".
Et là, tu te demandes si tu es en train de lire du français ou une langue extraterrestre. Pas de panique ! C'est exactement ce que je ressentais il y a quelques années. Ces termes semblent intimidants, mais une fois qu'on te les explique avec des mots normaux, tu te rends compte que c'est beaucoup plus simple que ça en a l'air.
J'ai créé ce dictionnaire pour toi. Garde cette page en favori, tu y reviendras souvent au début, et c'est parfaitement normal.
La Philosophie de Ce Guide
Je vais t'expliquer chaque terme avec deux approches :
- Une métaphore de la vraie vie (souvent liée à la cuisine ou au quotidien)
- L'explication technique en langage simple
Et pour chaque terme, je te donne le prompt à utiliser avec Claude si tu veux faire cette action dans ton projet. Comme ça, tu n'as même pas besoin de retenir les commandes techniques.
Les Termes de Base : Git et les Sauvegardes
Ces termes concernent Git, l'outil qui permet de sauvegarder ton code et de travailler en équipe. Si tu veux approfondir, j'ai écrit un guide complet sur Git pour les débutants.
Commit
La métaphore cuisine : C'est noter une modification dans ton carnet de recettes personnel. Tu écris "J'ai ajouté une pincée de sel à la sauce" avec la date. Plus tard, tu pourras relire toutes tes modifications.
En technique : Tu sauvegardes l'état actuel de ton code avec un petit message qui explique ce que tu as changé. C'est comme prendre une photo de ton projet à un instant T.
Pourquoi c'est utile : Si tu fais une bêtise plus tard, tu peux revenir à n'importe quelle photo précédente.
Demande à Claude :
Fais un commit avec le message 'ajout du bouton contact sur la page d'accueil'
Push
La métaphore cuisine : Tu envoies ta recette modifiée au livre de recettes central de la famille, stocké dans le cloud. Comme ça, même si ton carnet personnel prend feu, la recette est sauvegardée ailleurs.
En technique : Tu envoies tes commits (tes sauvegardes locales) sur un serveur distant comme GitHub. C'est une copie de sécurité accessible de partout.
Pourquoi c'est utile : Si ton ordinateur tombe en panne, ton code est en sécurité sur Internet. Et tu peux y accéder depuis n'importe quel autre ordinateur.
Demande à Claude :
Pousse mes modifications sur GitHub
Pull
La métaphore cuisine : Tu récupères les dernières recettes que ta grand-mère a ajoutées au livre familial. Elle a fait des modifications de son côté, tu veux les avoir sur ton carnet.
En technique : Tu récupères les dernières modifications depuis le serveur (GitHub) vers ton ordinateur. Utile quand tu travailles sur plusieurs ordinateurs ou avec d'autres personnes.
Demande à Claude :
Récupère les dernières modifications depuis GitHub
Branch (Branche)
La métaphore cuisine : Tu photocopies la recette de tarte aux pommes pour tester une nouvelle garniture (des poires à la place des pommes). Si ça rate, tu n'as pas abîmé la recette originale. Si ça marche, tu pourras l'intégrer.
En technique : Tu crées une copie parallèle de ton projet pour faire des expériences sans risquer de casser la version qui fonctionne. C'est un filet de sécurité pour tester des idées.
Pourquoi c'est utile : Tu peux tester une nouvelle fonctionnalité risquée sans impacter le site qui est en ligne.
Demande à Claude :
Crée une nouvelle branche appelée 'test-nouveau-design' pour expérimenter un nouveau design
Merge (Fusionner)
La métaphore cuisine : Ta nouvelle garniture aux poires est validée ! Tu l'ajoutes officiellement à la recette originale dans le livre familial.
En technique : Tu intègres les modifications de ta branche expérimentale dans la branche principale (souvent appelée "main" ou "master"). Tes expériences deviennent officielles.
Demande à Claude :
Fusionne ma branche 'test-nouveau-design' dans la branche principale
Pull Request (PR)
La métaphore cuisine : Tu proposes ta recette modifiée au chef (ou à toi-même dans un autre rôle) pour qu'il la goûte et la valide avant de l'ajouter au menu officiel du restaurant.
En technique : Tu demandes officiellement que tes modifications soient vérifiées et validées avant d'être fusionnées. C'est un processus de revue, même si tu travailles seul (tu peux relire ton propre travail avec du recul).
Pourquoi c'est utile : Ça t'oblige à faire une pause et à vérifier ton travail avant de l'intégrer définitivement.
Demande à Claude :
Crée une Pull Request sur GitHub pour ma branche actuelle
Les Termes de Mise en Ligne
Ces termes concernent le moment où ton site passe de ton ordinateur à Internet. J'ai écrit un guide détaillé sur le déploiement si tu veux approfondir.
Deploy (Déployer)
La métaphore cuisine : Le plat sort de la cuisine et arrive sur la table du client. Ce n'est plus un brouillon dans ta cuisine, c'est un plat servi au restaurant.
En technique : Ton site/application passe de ton ordinateur local (que toi seul peut voir) à Internet, accessible par tout le monde via une adresse web.
Demande à Claude :
Comment je déploie mon site sur Vercel ?
Production (ou "Prod")
La métaphore cuisine : La salle du restaurant où les vrais clients mangent. Pas de droit à l'erreur, pas d'expériences hasardeuses. Tout doit être parfait.
En technique : L'environnement où ton site est visible par les vrais utilisateurs. C'est la version "officielle" de ton projet. On ne teste pas en production (normalement).
Exemple concret : Quand tu vas sur google.com, tu es sur leur environnement de production.
Staging / Pré-prod
La métaphore cuisine : La table du chef où on goûte le plat avant de l'envoyer en salle. On vérifie que tout est bon, que la présentation est correcte.
En technique : Une copie de ton site de production, mais accessible uniquement par toi et ton équipe, pour tester les nouvelles fonctionnalités avant de les mettre en ligne pour tout le monde.
Pourquoi c'est utile : Tu peux vérifier que tout fonctionne dans des conditions réelles sans risquer de casser le site visible par tes utilisateurs.
Localhost
La métaphore cuisine : Ta cuisine personnelle à la maison. Tu es le seul à voir ce que tu prépares.
En technique : L'adresse http://localhost:3000 (ou un autre numéro) désigne ton ordinateur lui-même. Quand tu développes, ton site tourne sur ton ordinateur et n'est visible que par toi.
Exemple concret : Tu lances ton projet, tu vois "localhost:3000" dans ton navigateur. Personne d'autre sur Internet ne peut y accéder, c'est uniquement sur ta machine.
Les Termes de Base de Données
Ces termes concernent l'endroit où tu stockes les données de ton application (utilisateurs, produits, commandes...). J'ai écrit un guide sur les bases de données avec Supabase si tu veux créer la tienne.
Base de données
La métaphore cuisine : Ton classeur de fiches recettes, ultra bien organisé avec des intercalaires et un index.
En technique : Un système qui stocke toutes tes données de manière structurée et organisée. C'est comme un super Excel, mais en beaucoup plus puissant et sécurisé.
Exemple concret : La liste de tous tes utilisateurs, leurs emails, leurs mots de passe (cryptés !), leurs achats...
Table
La métaphore cuisine : Une catégorie dans ton classeur : "Entrées", "Plats", "Desserts". Chaque catégorie a ses propres fiches.
En technique : Un "tableau" dans ta base de données qui stocke un type de données. Par exemple : une table "utilisateurs", une table "produits", une table "commandes".
Query (Requête)
La métaphore cuisine : "Donne-moi toutes les recettes avec du chocolat qui prennent moins de 30 minutes à préparer."
En technique : Une question que tu poses à ta base de données pour récupérer des informations spécifiques. Par exemple : "Donne-moi tous les utilisateurs qui se sont inscrits ce mois-ci."
Demande à Claude :
Écris-moi une requête SQL pour récupérer tous les utilisateurs inscrits après le 1er janvier 2026
SQL
En simple : C'est le langage que tu utilises pour parler à ta base de données. C'est comme l'anglais pour parler à un étranger : c'est la langue commune que toutes les bases de données comprennent.
La bonne nouvelle : Tu n'as pas besoin de l'apprendre par cœur. Tu demandes à Claude de t'écrire les requêtes SQL !
Les Termes Techniques Généraux
API
La métaphore cuisine : Le passe-plat entre la cuisine et la salle. Le serveur y dépose les commandes des clients ("table 5 veut une pizza"), le cuisinier y récupère les instructions et y dépose les plats prêts.
En technique : Un moyen standardisé pour deux applications de communiquer entre elles. Ton site (la salle) demande des données à ton serveur (la cuisine) via l'API (le passe-plat).
Exemple concret : Quand tu affiches la météo sur ton site, ton site appelle l'API d'un service météo qui lui renvoie les données.
Frontend
La métaphore cuisine : La salle du restaurant, ce que le client voit et touche. La décoration, les tables, les menus.
En technique : La partie visible de ton site ou application. Tout ce que l'utilisateur voit et avec quoi il interagit : les boutons, les textes, le design, les animations.
Backend
La métaphore cuisine : La cuisine, cachée du client mais essentielle. C'est là que le vrai travail se fait.
En technique : La partie invisible qui gère la logique, les données, la sécurité. L'utilisateur ne la voit jamais, mais c'est elle qui fait que tout fonctionne.
Bug
La métaphore cuisine : Un cheveu dans la soupe. Quelque chose qui ne devrait pas être là et qui gâche l'expérience.
En technique : Un comportement inattendu ou une erreur dans ton code. Ça arrive à absolument tout le monde, même aux meilleurs.
Debug
La métaphore cuisine : Chercher d'où vient le cheveu (le cuisinier ? le fournisseur ?) et mettre en place des mesures pour que ça n'arrive plus.
En technique : Le processus de trouver et corriger un bug. C'est souvent 90% de recherche et 10% de correction.
Demande à Claude :
J'ai cette erreur : [colle ton erreur ici]. Peux-tu m'aider à comprendre ce qu'elle signifie et comment la corriger ?
Terminal (ou Console, ou Ligne de commande)
La métaphore : Un groupe WhatsApp avec ton ordinateur où tu lui envoies des messages texte au lieu de cliquer sur des icônes.
En technique : L'écran noir où tu tapes des commandes textuelles pour contrôler ton ordinateur. C'est plus direct et plus puissant que l'interface graphique.
Pourquoi ça fait peur : Parce que c'est nouveau et que ça ressemble aux films de hackers. En réalité, c'est juste une autre façon de parler à ton ordinateur.
Framework
La métaphore cuisine : Une cuisine équipée avec tous les outils déjà installés (four, frigo, casseroles, ustensiles). Tu n'as plus qu'à cuisiner, tout est prêt.
En technique : Un ensemble d'outils et de conventions pré-configurés pour créer des applications. Next.js, React, Vue.js sont des frameworks. Ils te font gagner du temps en fournissant une structure de base.
.env (fichier d'environnement)
La métaphore : Le coffre-fort du restaurant où sont gardés les codes d'alarme, les clés de la caisse, et le code du WiFi privé.
En technique : Un fichier qui contient tes secrets : mots de passe, clés API, informations sensibles. Ce fichier ne doit JAMAIS être partagé ou mis sur GitHub. J'ai écrit un guide sur la protection de tes secrets.
Le Mémo Rapide
| Terme | En 3 mots |
|---|---|
| Commit | Sauvegarder + message |
| Push | Envoyer sur serveur |
| Pull | Récupérer du serveur |
| Branch | Copie pour tester |
| Merge | Fusionner les modifs |
| PR | Demander validation |
| Deploy | Mettre en ligne |
| Frontend | Ce qu'on voit |
| Backend | Ce qui est caché |
| API | Communication entre apps |
| Bug | Ça marche pas |
| Debug | Réparer le bug |
| Terminal | Écran noir commandes |
| .env | Fichier secrets |
La Bonne Nouvelle
Avec Claude Code, tu n'as pas besoin de retenir tout ce vocabulaire ! Tu peux simplement parler en français normal :
Sauvegarde mon travail et envoie-le sur GitHub avec un message qui explique que j'ai ajouté un formulaire de contact
Claude comprend le français et traduit ça en commandes techniques pour toi. C'est comme avoir un traducteur bilingue français-développeur en permanence à tes côtés.
Garde cette page en favori. Tu y reviendras souvent au début, et c'est parfaitement normal. Chaque développeur est passé par là. Plus tu pratiques, plus ces termes deviendront naturels.
Pour Aller Plus Loin
Pour ceux qui veulent aller plus loin : on a créé le Workshop "Bâtir avec l'IA".
Articles connexes pour approfondir :
- Git pour les nuls - Pour maîtriser les sauvegardes
- Mettre en ligne ton site - Le guide du déploiement
- Créer une base de données - Passer d'Excel à Supabase
- L'écran noir vous fait peur ? - Apprivoiser le terminal
Outils mentionnés :
- GitHub - Pour stocker ton code en ligne
- Vercel - Pour déployer tes sites
- Supabase - Pour créer des bases de données
— Charles
