Retour au site
Français

Étudier du code, de la documentation et de la matière technique

De la documentation, un framework à maîtriser pour lundi, un langage que vous voulez apprendre vraiment plutôt qu'en copiant des extraits : tout cela fonctionne comme n'importe quel autre sujet. Cette page explique comment importer de la matière technique, ce que contiennent les explications, et le seul endroit où l'audio est le mauvais outil.

💬
Vous pouvez suivre un tutoriel jusqu'au bout et rester incapable de construire la chose sans lui. Suivre n'est pas savoir.

Cela fonctionne pareil, avec du code dans les explications

Un sujet technique se comporte comme un autre : il devient un parcours de sous-thèmes, le Mode Explication vous les fait parcourir, et les explications comportent des exemples de code travaillés en plus des schémas et des encadrés. Ensuite le Mode Quiz et le Mode Examen vous interrogent. La différence utile avec la lecture de documentation, c'est que la documentation ne vous demande jamais rien en retour.

Importer de la matière technique

  • De la documentation en PDF — la plupart des sites de documentation et des références d'API peuvent être imprimés ou exportés en PDF, et cela s'importe normalement.
  • Un ouvrage technique ou le PDF d'un cours — importez-le par chapitres plutôt qu'en entier, pour que chaque sujet garde une taille exploitable.
  • Ou décrivez-le simplement — « le cycle de vie des hooks React », « le fonctionnement de l'attention dans les transformers », « le flux OAuth device ». Pour une technologie établie, c'est souvent plus rapide que de chercher un document, et c'est la voie que couvrent vos crédits offerts.
  • Pas un dépôt — vous ne pouvez pas le pointer vers un dépôt GitHub ni vers une URL, et il ne lit pas une base de code. Importez la documentation ou décrivez le concept.

L'audio est le mauvais outil pour le code

La Lecture à voix haute dit le texte tel qu'il est écrit : un bloc de code est donc lu symbole par symbole et devient un bruit inutilisable. C'est une limite réelle, à connaître avant de l'essayer sur une section technique. La conversation parlée s'en sort autrement et mieux : elle a pour consigne de ne jamais lire à voix haute du code, une URL ou un tableau, et de dire à la place que c'est à l'écran en décrivant ce que cela fait.

Réservez l'audio aux concepts et l'écran au code. Un épisode de podcast sur « ce qu'est une situation de compétition et pourquoi les verrous aident » fonctionne bien ; un épisode qui lit une signature de fonction, non.

Expliquer une idée technique à voix haute

C'est là que la matière technique tire le plus de la conversation parlée, car une grande part du métier consiste à expliquer une décision à quelqu'un d'autre. Raisonnez à voix haute sur l'intérêt d'une file ici, défendez un choix de schéma, ou tentez d'expliquer ce que fait selon vous un morceau de code — et laissez-vous pousser là où vous restiez vague. C'est aussi la répétition la plus proche d'un entretien technique, qui a sa propre page.

Questions fréquentes

Gère-t-il le code ?
Oui. Les explications comportent des exemples de code travaillés en plus des schémas et des encadrés, et les quiz et examens sont générés à partir de la même matière.
Puis-je importer une documentation d'API ou un ouvrage technique ?
Oui, en PDF. La plupart des documentations peuvent être imprimées en PDF, et un ouvrage long s'importe mieux chapitre par chapitre pour que chaque sujet garde une taille exploitable.
Puis-je le pointer vers un dépôt GitHub ou une URL de documentation ?
Non. Il ne récupère pas d'URL et ne lit pas de base de code. Importez la documentation en PDF, ou décrivez la technologie et laissez-le construire le parcours à partir de là.
Peut-il lire du code à voix haute ?
La Lecture à voix haute dit le texte exactement tel qu'il est écrit : un bloc de code devient donc un bruit symbole par symbole — ne l'utilisez pas pour du code. La conversation parlée est différente : elle ne lit pas le code et décrit ce qui est à l'écran.
Puis-je m'en servir pour apprendre l'IA et l'apprentissage automatique ?
Oui, et c'est l'un des sujets les plus créés ici. Décrivez le domaine voulu — architectures de modèles, évaluation, prompting, peu importe — ou importez l'article ou la documentation sur laquelle vous travaillez.