Textbook Anything
Transformez un point de départ étroit en matériel qu'un lecteur peut apprendre de manière autonome. Un article peut présenter une contribution tout en supposant des années de connaissances préalables. Identifiez ces connaissances préalables, enseignez les parties nécessaires pour comprendre la contribution et donnez au lecteur l'occasion d'utiliser les idées. Le flux de travail et les références ici sont autonomes.
Appliquez le même niveau d'explication et de conception visuelle dans tous les formats. Le passage entre LaTeX, HTML, un autre système de documents et un PDF imprimé change l'implémentation, pas les objectifs d'apprentissage, les détails mathématiques, la signification des figures ou la lisibilité. Préservez la fonction pédagogique de chaque visuel lors de son adaptation à l'environnement disponible.
1. Établir le lecteur et la tâche
Lisez d'abord le matériel fourni. Identifiez l'objectif d'apprentissage, les connaissances préalables, la langue, la date de coupure des sources, la profondeur demandée, le contenu à préserver et les livrables. Pour l'étude d'un article, supposez que le lecteur est novice dans les méthodes spécialisées de l'article, sauf indication contraire ; ne supposez pas qu'il manque de toutes les mathématiques universitaires.
En règle générale, comblez les lacunes importantes avec une ou deux questions d'ouverture ciblées, une à la fois. Établissez le niveau le plus bas qui nécessite une explication et ce que le lecteur devrait être capable de dériver, d'implémenter ou d'évaluer à la fin. Recommandez une hypothèse à partir du matériel déjà disponible. Ne posez pas de questions auxquelles l'utilisateur a déjà répondu.
Pour une exécution que l'utilisateur identifie comme GPT Pro, ou qui est explicitement identifiée comme telle par un contexte d'exécution fiable, sautez cet entretien d'ouverture. Honorez également toute demande de procéder sans questions. Enregistrez les hypothèses raisonnables sur l'apprenant et continuez ; n'inférez pas le mode Pro à partir du nom d'une famille de modèles ou de l'absence de réponses. Sauter l'entretien ne signifie pas sauter la recherche, la planification ou la révision.
Après l'entretien, ou immédiatement dans le cas d'absence d'entretien, remplissez le tableau des exigences dans le cahier des charges pédagogique. Affichez le plan concis une fois : résultat d'apprentissage, prérequis, source, accent prévu, explication ou visuel, pratique et évaluation. Conservez les notes de travail détaillées en dehors du tutoriel.
Préservez la portée de la tâche. Une révision renvoie des résultats sans modification. Une révision locale reste locale. Le flux de travail du tutoriel s'applique à une leçon complète sur un article, un chapitre substantiel ou un livre ; il ne doit pas transformer chaque demande en livre.
2. Préparer un environnement de travail
Vérifiez rapidement la chaîne d'outils demandée avec une petite construction représentative. Réutilisez les outils installés ; installez les dépendances manquantes à l'aide du gestionnaire de paquets disponible, de préférence dans un environnement de projet. Effectuez le travail d'installation dans le cadre des autorisations existantes plutôt que de renvoyer des instructions à l'utilisateur pour qu'il le fasse. Environnement et formats couvre l'installation, les vérifications de fonctionnement et les décisions de repli.
Si l'environnement préféré ne peut pas être installé ou exécuté après une tentative de réparation raisonnable, continuez avec un format capable comme HTML, CSS, SVG, MathML natif et JavaScript. Préservez la profondeur pédagogique, les mathématiques, les visuels et les exercices. Livrez le HTML fonctionnel et les ressources ; exportez un PDF lorsqu'un moteur de rendu de navigateur est disponible. Signalez avec précision un format demandé indisponible.
3. Rechercher les dépendances
Tracez l'article ou le sujet central à travers les méthodes sur lesquelles il s'appuie réellement. Une référence qui fournit un objectif, une dérivation, une architecture ou une méthode d'évaluation mérite une explication au niveau du lecteur, même si l'article central ne fait que la citer. Suivez les prérequis de cette méthode jusqu'à atteindre la base convenue. Évitez de résumer récursivement des citations sans rapport.
Utilisez sources et couverture et conception d'article en tutoriel. Distinguez les fondations, les méthodes héritées, la contribution centrale et les affirmations empiriques. Rendez leurs relations explicites avant de choisir un ordre de chapitre.
Lorsqu'une version arXiv existe, inspectez son archive source pour les illustrations originales et le TeX qui les place et les légende. Préférez les figures originales appropriées aux captures d'écran avec perte. Figures d'articles explique l'extraction, l'attribution et l'inclusion des ressources utilisables dans le ZIP de livraison.
4. Concevoir l'ensemble du tutoriel
Utilisez conception pédagogique pour relier les résultats, les explications, les exemples et la pratique. Allouez de l'espace en fonction des lacunes de prérequis et de la difficulté conceptuelle. Gardez la méthode centrale substantielle ; déplacez les connaissances de base optionnelles ou les longues solutions vers des sections clairement liées lorsqu'elles interrompent l'argument principal.
Donnez à chaque section une question qui mérite une réponse. Présentez un cadre concret, expliquez les objets nécessaires, développez l'argument et interprétez le résultat. Un exemple travaillé doit expliquer le choix de la méthode et l'étape décisive. Lisez rédaction avant de rédiger et appliquez-la à l'ensemble du document, y compris les légendes et les solutions.
Choisissez les visuels en fonction de ce qu'ils expliquent : une carte des dépendances, une géométrie, un calcul, une comparaison empirique, un système en évolution ou l'effet d'un paramètre. Utilisez conception visuelle et typographie pour la variété avec un langage visuel cohérent. Les figures originales d'articles et les figures pédagogiques nouvellement dessinées peuvent servir à des fins différentes dans la même section.
Les autres références s'appliquent lorsque nécessaire :
| Travail | Référence |
|---|---|
| Raisonnement mathématique | Dérivations |
| Pratique, indices et solutions | Exercices, modèles d'exercices |
| Implémentations et expériences | Code et expériences |
| Construire, inspecter et empaqueter | Livraison, aides locales |
5. Effectuer deux ou trois cycles complets
Pour les tutoriels substantiels, effectuez deux cycles complets par défaut. Utilisez un troisième lorsque des chaînes de prérequis profondes, des mathématiques étendues, une nouvelle voie de rendu ou les résultats du deuxième cycle le justifient. Honor ez une demande explicite de l'utilisateur pour un budget différent. Suivez la boucle de tutoriel : revisitez les exigences et les sources, travaillez sur l'ensemble de la portée demandée, produisez l'artefact réel, inspectez-le, résolvez ou testez les exercices, révisez la prose, corrigez les défauts et mettez à jour le tableau des exigences.
Chaque cycle se termine par une auto-évaluation concrète. Deux passages du compilateur sont une construction, pas deux cycles. N'inventez pas de défauts et ne prétendez pas à une révision indépendante lorsque le même auteur l'a effectuée. Après les cycles prévus, réparez les blocages restants dans la portée affectée ; ne prétendez pas à l'achèvement uniquement parce que le nombre de cycles a été atteint.
6. Livrer le tutoriel
Fournissez d'abord l'artefact de lecture demandé, puis un ZIP avec le code source modifiable, les ressources visuelles locales, le code applicable, les solutions et des instructions de construction concises. Incluez l'attribution des figures d'article réutilisées. Conservez les registres de recherche et les enregistrements de cycle séparément, sans insérer l'historique de production dans le texte de l'apprenant ou un fichier README public.
Vérifiez que la copie livrée s'ouvre ou se reconstruit sans fichiers provenant d'un répertoire de travail temporaire. Distinguez le raisonnement mathématique, les tests numériques, les expériences et la révision visuelle dans toute note de livraison. Un outil ou une source manquant doit restreindre l'affirmation pertinente, et non empêcher l'achèvement des parties qui peuvent être faites.