Comprendre ce qui a été produit

Un programme que l'on ne comprend pas reste la propriété de quelqu'un d'autre. Aujourd'hui, vous vous le faites expliquer ligne à ligne, en français. Vous saurez où poser la main pour le changer, et ce qu'il fait de vos données.

Objectif : À la fin, vous saurez vous faire expliquer un programme ligne à ligne, en français, et repérer les lignes que vous pouvez modifier.

La vidéo

Les sous-titres sont affichés par défaut.

Transcription (le texte de la vidéo)

Dans cette leçon, vous allez lire un programme que vous n'avez pas écrit. Sans devenir informaticien, et sans apprendre par cœur. À la fin, vous saurez vous faire expliquer un outil ligne à ligne, en français, et repérer les trois endroits qui comptent. Ceux que vous pourrez changer, et ce que l'outil fait de vos données.

Vous n'avez pas écrit ce programme. Vous devez pourtant savoir ce qu'il contient. Trois raisons. La première est pratique. Pour modifier un outil, il faut savoir où poser la main. Le taux, la couleur, le nombre de questions : ces valeurs sont écrites en clair. La deuxième est une question de confiance. Un programme peut aller chercher quelque chose ailleurs, ou envoyer ce que vous tapez. Ce n'est pas forcément mauvais, mais vous devez le savoir. La troisième est le plaisir. Comprendre trois lignes aujourd'hui, cinq demain, et le mystère tombe.

Une explication vague ne sert à rien. Voici la demande que nous utilisons. Expliquez ce programme ligne à ligne, en français, à quelqu'un qui n'a jamais programmé. Une phrase par ligne, pas davantage. N'employez aucun mot technique sans le définir aussitôt. Terminez en me disant quelles lignes je peux modifier sans rien casser. Trois consignes font tout le travail. Une phrase par ligne empêche les digressions. Chaque mot défini vous évite de chercher ailleurs. Et la dernière transforme l'explication en mode d'emploi. Si un point reste obscur, reposez la question sur ce point seul.

Regardez l'écran. Nous reprenons la calculatrice de la leçon précédente et nous demandons l'explication. L'IA isole quatre lignes. La première crée une étiquette nommée total, et y range cent. Une étiquette de ce genre s'appelle une variable. La deuxième range quatre dans une variable nommée personnes. La troisième divise l'une par l'autre. La quatrième affiche le résultat, grâce à un bloc appelé fonction. Puis l'IA nous dit quoi modifier sans risque : les valeurs, et le texte affiché. Un mot nous arrête, nous reposons la question, et une image règle l'affaire. Enfin nous vérifions : aucune adresse internet, tout reste dans la page.

À vous maintenant. Reprenez la conversation où votre outil a été fabriqué. Demandez l'explication ligne à ligne, une phrase par ligne, chaque mot défini. Demandez ensuite où sont les valeurs que vous pouvez changer. Et si le programme envoie quelque chose en dehors de la page. Reposez une question sur le seul point resté obscur. Vous ne pouvez rien casser.

Retenez ceci. Une variable est une étiquette posée sur une valeur. Une fonction est un bloc qui fait une chose et porte un nom. Lire un programme sert à deux choses très concrètes. Savoir où poser la main pour le modifier. Et vérifier que rien ne sort de la page sans votre accord. Dans la prochaine leçon, nous ferons évoluer cet outil, et nous ferons corriger une erreur.

L'idée

Je demande l'explication ligne à ligne, en français, une phrase par ligne. Je repère les valeurs modifiables et ce qui sort de ma page.

La démonstration

Voici l'exemple, entièrement fait sous vos yeux, avant que vous ne le fassiez vous-même.

Nous reprenons la calculatrice de la leçon précédente, dans la même conversation. Nous écrivons : « Expliquez ce programme ligne à ligne, en français, à quelqu'un qui n'a jamais programmé. Une phrase par ligne. Définissez chaque mot technique. Terminez en me disant quelles lignes je peux modifier sans rien casser. »

Exemple de réponse : « Voici les quatre lignes qui font le calcul.

const total = 100; const personnes = 4; const part = total / personnes; afficher(part);

Reprenons dans l'ordre. Ligne 1 : le mot const crée une étiquette nommée total et y range la valeur cent. Une étiquette de ce genre s'appelle une variable. Ligne 2 : une deuxième variable, personnes, contient quatre. Ligne 3 : on divise l'une par l'autre, et le résultat est rangé dans part. Ligne 4 : afficher est une fonction, c'est-à-dire un bloc qui fait une chose ; ici, écrire la part à l'écran.

Vous pouvez modifier sans risque les valeurs cent et quatre, et le texte affiché. Évitez de toucher aux barres obliques et aux points-virgules : ce sont des marques de ponctuation du langage. »

Une phrase nous arrête : afficher. Nous reposons la question : « reprenez le mot fonction avec une image de la vie courante ». L'IA répond qu'une fonction est une recette du carnet : on l'appelle par son nom, elle fait son travail.

Nous demandons enfin si le programme envoie quelque chose à l'extérieur. Réponse : aucune adresse internet, tout se passe dans la page. Nous voilà tranquilles.

L'exercice guidé

Vous ne pouvez rien casser.

Vous ne pouvez rien casser. 1. Retournez dans la conversation où votre outil a été fabriqué, ou refaites-en un. 2. Collez la demande ci-dessus en remplissant les crochets avec vos propres exemples. 3. Lisez l'explication en entier, puis reposez une question sur le seul point resté obscur. 4. Notez sur un papier les lignes que vous pourriez modifier, et ce que fait chacune. 5. Vérifiez à l'œil qu'aucune adresse commençant par http ne figure dans le programme.

La consigne à copier :

Expliquez ce programme ligne à ligne, en français, à quelqu'un qui n'a jamais programmé. Une phrase par ligne, pas davantage. N'employez aucun mot technique sans le définir aussitôt. Puis répondez à trois questions. Où sont les valeurs que je peux changer, par exemple [le taux, le nombre de personnes, le texte affiché] ? Ce programme envoie-t-il quelque chose en dehors de ma page ? Et si je voulais [le changement envisagé : afficher deux décimales, changer la couleur du bouton], quelle ligne devrais-je modifier ?

Trois vérifications

Cochez chaque phrase quand elle est vraie pour vous :

Je vois une explication d'une phrase par ligne, sans mot technique laissé sans définition.
Je vois quelles lignes contiennent les valeurs que je pourrais vouloir changer.
Je vois si le programme envoie quelque chose en dehors de ma page.
Je sais redire, avec mes mots, ce que sont une variable et une fonction.

Le quiz de la leçon

5 questions. La réponse est expliquée tout de suite. Vous pouvez réessayer autant de fois que vous voulez : aucune note n'est gardée.

1. L'IA vous rend une explication remplie de mots que vous ne connaissez pas. Que faites-vous ?

2. Dans le programme de votre convertisseur, une ligne contient une adresse qui commence par http. Que faites-vous ?

3. Vous voulez changer le taux de votre convertisseur. Où cherchez-vous en priorité ?

4. Une seule ligne de l'explication reste obscure pour vous. Que faites-vous ?

5. Votre outil fonctionne. Vous hésitez à lire le programme. Quel argument vous décide ?

Garder votre place

Et maintenant

D'ici demain, reprenez l'explication reçue et soulignez sur papier les deux lignes qui contiennent des valeurs modifiables. Écrivez à côté ce que chacune fait, avec vos mots. Cette feuille sera votre plan quand vous voudrez changer l'outil. Nous vous reposerons une question dans 3 jours.

Comment avez-vous trouvé cette leçon ?

Deux questions, dix secondes. Vos réponses servent à corriger les leçons suivantes : c'est notre seul moyen de savoir ce qui passe mal.

Les mots de cette leçon

Variable: Une étiquette posée sur une valeur : un nom, et ce qu'il contient. Le programme s'en sert par ce nom.
Fonction: Un bloc qui fait une chose et porte un nom. On l'appelle par son nom, comme une recette du carnet.
Ligne à ligne: Une explication qui reprend chaque ligne du programme, l'une après l'autre, en une phrase.
Point-virgule: Une marque de ponctuation du langage, qui termine une instruction. On n'y touche pas.
Adresse internet: Le chemin d'une page ou d'un service en ligne. Dans un programme, elle signale un échange avec l'extérieur.

Tout le glossaire