Présentation du code et enregistrement d'écran : affichez la décision, pas le bureau

Publié 23 août 2026 · Mis à jour 24 août 2026 · Jakub Kuźnicki

Politique de mise à jour : les faits produit, les sources citées et les résultats vérifiés sont revalidés lorsqu’ils changent. Voir la méthodologie de l’auteur.

La réponse courte : enregistrez la décision dont vous souhaitez vous souvenir

Un enregistrement d'écran montre l'ensemble du bureau : les onglets, le déplacement du curseur, le chrome de l'éditeur et le moment où l'auteur trouve la bonne ligne. Une présentation pas à pas du code peut montrer les petites choses dont un lecteur doit se souvenir : quelle branche s'exécute, ce qu'elle renvoie et pourquoi l'appel suivant suit. Aucun des deux formats n’est universellement meilleur. Le choix dépend si le spectateur a besoin de l'environnement ou du raisonnement. Pour cette note, j'ai utilisé le même appareil à six lignes dans les deux modèles mentaux, puis j'ai vérifié le flux de travail par rapport aux contrôles de source de Scribe. La sortie vérifiée ci-dessous est ce luminaire rendu à 1920 × 1080 et 24 ips ; ce n'est pas une référence. Vous pouvez coller l'entrée dans Scribe et prenez cette décision avec votre propre code.

L'entrée : une agence, un site d'appel

Le luminaire est volontairement ordinaire. Il normalise un chemin facultatif, puis appelle l'assistant une fois. Cela donne à l'explication un tour visible au lieu de prétendre qu'un petit extrait prouve comment chaque référentiel doit être enseigné.

function choosePath(path?: string) {
  if (!path) return "/";
  return path.startsWith("/") ? path : `/${path}`;
}

choosePath("docs");

Pour la révision des sources, le flux de travail consistait à coller, choisir le profil TypeScript, prévisualiser et relire. La même entrée est ce qui ancre la comparaison ; il n’y a aucune animation stock cachée derrière la prose.

Ce que conserve l'enregistrement d'écran

• Le contexte de l'éditeur, du terminal ou du navigateur environnant lorsque l'environnement fait partie de la leçon.
• Un véritable chemin de curseur lors de la localisation d'un fichier ou de la reproduction d'un bug visible est important.
• Les parties délicates d’une opération en direct, si le public doit répéter exactement cette opération.

Ce contexte est utile, mais il demande également au spectateur de filtrer. Un enregistrement peut donner l'impression qu'une décision en trois lignes ressemble à une visite de la machine de l'auteur. Si le bureau ne fait pas partie de la leçon, coupez-le dans le script avant d'appuyer sur Enregistrer.

Quelle procédure pas à pas rend lisible

Une procédure pas à pas vous permet de diviser l'explication lors de la décision : d'abord le chemin vide devient la racine, puis un chemin sans barre oblique en obtient une, puis le site d'appel fournit l'entrée concrète. La lecture ligne par ligne de Scribe est utile pour cette structure car le spectateur voit l'ordre que vous avez choisi plutôt qu'un curseur se promenant sur un bureau. Le page de fonctionnalités décrit la surface du développeur sans transformer ce luminaire en référence.

Avant d'exporter, gardez la source lisible, supprimez les lignes sans rapport et décidez si un cadre large ou vertical convient à l'endroit où le clip sera hébergé. Tarifs explique l'indemnité d'exportation ; la prévisualisation reste le moyen le plus simple de tester si l'explication est lisible.

Une règle de décision pratique

• Utilisez un enregistrement d'écran lorsque l'environnement est une preuve : une configuration, une reproduction ou une interaction visible.
• Utilisez une procédure pas à pas lorsque le spectateur a besoin d’une branche, d’une séquence ou d’une relation pour rester en mémoire.
• Utilisez les deux uniquement lorsque le deuxième format ajoute du contexte au lieu de répéter le premier.

Le test honnête n’est pas de savoir quel format semble le plus raffiné. Demandez ce qu'un téléspectateur devrait être capable d'expliquer dix minutes plus tard. Si la réponse est « là où j’ai cliqué », conservez le bureau. S’il s’agit de « pourquoi cette branche fonctionne », faites du raisonnement le cadre.

Preuve et limite de cette note

L'appareil, le flux de travail, les résultats vérifiés et les observations de la source sont enregistrés dans le manifeste des preuves de première partie. Le clip est un exemple contrôlé, et non une affirmation sur chaque résultat du référentiel, du navigateur ou du spectateur. Pour un exemple concret associé avec un clip coché, lisez Expliquez votre code en 60 secondes.

Essayez le flux de travail dans Scribe, lisez le fonctionnalités du développeur, vérifier prix, ou continuez avec l'explication du code vérifié.