Expliquer un système technique
Expliquer du général au particulier, simplifier et vérifier qu'on est compris.
Une bonne explication au travail aux États-Unis part de la vue d'ensemble, descend dans les détails, et s'arrête pour vérifier que tout le monde suit. Demander 'does that make sense so far?' montre de l'assurance, pas de l'hésitation. Attention : « make sense » se dit avec make, pas « have sense ».
- 1
Let me start with the big picture.
Je commence par la vue d'ensemble.
- 2
There are three main pieces to it.
Il y a trois briques principales.
- 3
A request comes in on this side first.
Une requête arrive d'abord de ce côté-ci.
- 4
Then it goes through the auth layer before anything.
Ensuite, elle passe par la couche d'auth avant tout le reste.
- 5
That's where it hits the database.
C'est là qu'elle tape dans la base de données.
- 6
Does all that make sense so far?
Jusque-là, tout ça est clair ?
- 7
Let's zoom in on that part.
Zoomons sur cette partie.
- 8
Let's zoom back out for a second.
Prenons un peu de recul une seconde.
- 9
Think of it like a mailbox.
Imagine ça comme une boîte aux lettres.
- 10
That's a simplification, but it works.
C'est simplifié, mais ça marche.
- 11
The details are a bit messier.
Dans le détail, c'est un peu plus compliqué.
- 12
That part is legacy.
Cette partie, c'est du legacy.
- 13
Nobody wants to touch it, honestly.
Franchement, personne ne veut y toucher.
- 14
We're planning to replace it this year.
On prévoit de le remplacer cette année.
- 15
What could go wrong here?
Qu'est-ce qui pourrait mal tourner ici ?
- 16
Good question, that's the weak spot.
Bonne question, c'est le point faible.
- 17
Any questions before I go on?
Des questions avant que je continue ?
- 18
I'll send a diagram after this.
Je vous envoie un schéma après.
- 19
Let's walk through it again next week.
Reprenons ça étape par étape la semaine prochaine.
- 20
Thanks for following along.
Merci d'avoir suivi.