Comment les auteurs de l'atelier rédigent des cours éducatifs

Il y a une grande équipe derrière chacun des cours de Yandex.Practicum: développeurs, illustrateurs, concepteurs, méthodologistes, mentors, réviseurs de code et, bien sûr, auteurs et éditeurs qui rédigent le matériel de cours.



En bref, le programme de cours est créé comme suit:







Même après toutes ces étapes, le programme est complété et mis à jour. De nouvelles versions de langages de programmation et de frameworks sont publiés, le contexte d'utilisation des outils change, les retours des étudiants arrivent - tout cela est pris en compte lors de la compilation de la dernière version du cours.



Dans cet article, nous vous expliquerons comment le processus d'écriture des cours est organisé du côté des auteurs. Sous la coupe - les principales règles pour créer des cours utiles, le concept de la mort de l'auteur, les 5 choses que vous ne devriez pas faire si vous voulez écrire un bon cours et quelques histoires personnelles. Le billet sera utile aux spécialistes impliqués dans le processus de transfert des connaissances: chefs d'équipe, blogueurs techniques et créateurs de contenu pédagogique.



Comment soumettre du matériel



Le stage a des cours pour les étudiants débutants et avancés. Dans cet article, nous parlerons du premier groupe.



Le plus souvent, des étudiants viennent chez nous qui ne savent rien du tout sur le sujet, ou en savent pas mal. Bien que certains aient déjà étudié quelque chose par eux-mêmes, nous nous concentrons toujours sur le premier et essayons de présenter le matériel dans un langage simple.



Pour faciliter la perception du matériel par les élèves, nous le construisons sur des exemples tirés de la vie réelle. De cette façon, nous pouvons expliquer comment les variables, les fonctions, les boucles et tout le reste fonctionnent sans utiliser de termes compliqués. En règle générale, les étudiants débutants sont très reconnaissants lorsque nous expliquons les cycles non pas par l'exemple d'autres cycles, mais, par exemple, par l'exemple d'aller au réfrigérateur.





Un exemple du cours "Développeur C ++"



Nous sommes grandement aidés par l'expérience des auteurs eux-mêmes. Ils se souviennent bien comment ils ont eux-mêmes acquis des connaissances. Beaucoup d’entre eux n’ont pas simplement entassé la documentation, mais se sont racontés l’essence du sujet dans un format simplifié, en utilisant des exemples familiers, avec des comparaisons claires. Maintenant, ils font la même chose pour les autres.





Avec l'aide d'une mamie, d'une pelote de fil et d'un pull, nous expliquons ce qu'est un ORM dans le cours "Développeur python moyen" La



compétence pour expliquer des choses complexes à vous-même ou à votre équipe dans un langage simple est la pierre angulaire du travail de l'auteur .



Comment garder l'étudiant intéressé



Même un texte clair et utile peut encore devenir ennuyeux, nous essayons donc toujours de prendre en compte le contexte culturel moderne. Nous pensons qu'il est utile pour les auteurs de suivre les médias, d'être conscients du code culturel, de se souvenir des bons vieux classiques et de regarder de nouveaux films.





Référencer le "Cinquième élément" dans la rubrique Universal Passport du cours Python



Nous utilisons souvent des éléments de Pâques. Par exemple, le cours Java que nous préparons actuellement pour le lancement est construit comme un voyage avec un héros qui, au fur et à mesure de sa progression, résout divers problèmes. Nous cousons des œufs de Pâques dans le processus afin que l'étudiant ne résout pas seulement le problème, mais sourit également lorsqu'il voit une référence à sa série télévisée préférée ou à sa chanson célèbre.



Dans de nombreux cours, l'attention des étudiants est capturée par la narration. Même si le héros et son histoire sont fictifs, le matériel devient plus intéressant et mémorable pour le lecteur novice.



Par exemple, dans le nouveau cours «React Developer», une étudiante au tout début rencontre une héroïne qui obtient un emploi de serveuse dans un espace burger éloigné et rêve de la perfectionner. Tout au long de la formation, l'étudiant développe un site Web pour l'espace burger, et les héros de l'histoire le soutiennent: quand dans le travail de conception, il doit créer un blanc CRA et une structure de dossier pour les composants, l'héroïne présente son plan d'amélioration. le hamburger, et lorsque l'étudiant doit écrire le JSX et la composition en entier, les héros commencent à réparer le hamburger et à peindre les murs.





Space Waitress accompagne les étudiants sur le cours de développeur React



Dans la partie gratuite du cours de développement Python, les étudiants créent leur propre assistant personnel, Anfisa. Anfisa sait comment demander des informations sur des services tiers et utiliser les données reçues dans son travail. Elle tient une liste d'amis (comme dans un cahier), peut déterminer le temps qu'il fait dans la ville de chaque ami et offrir une glace à ses amis. Les amis sur la liste d'Anfisa sont les gars de notre équipe qui ont préparé le cours (un petit œuf de Pâques des auteurs). Et les villes où vivent des amis sont les villes où les gars de l'équipe sont réellement nés. Anfisa augmente progressivement au fur et à mesure que vous progressez dans le cours. Au tout début, Anfisa est petite, puisqu'elle ne sait toujours pas grand-chose. Mais progressivement, l'étudiant écrit le code, y ajoute différentes fonctions et Anfisa grandit.





Illustration tirée du cours de développeur Python : Une boîte ouverte est une leçon apprise, avec des éléments métaphoriquement liés à Django, et une nouvelle boîte est quelque chose qui reste à apprendre.



Quelles difficultés surgissent



Il est très important d'expliquer des phénomènes techniques complexes à l'aide d'exemples simples et d'associations familières. Mais tout ce qui concerne le monde de la programmation ne peut pas être transféré rapidement et facilement dans la vie de tous les jours. Certains exemples sont assez évidents, mais certains concepts sont difficiles à expliquer simplement.



Par exemple, comment expliquez-vous ce qu'est un cadre? Dans le cours Python Developer, nous le faisons comme ceci:



  • . , , . , , .



    , .



    . . , . , .



    . . . ( , ). : , , , . , .







    — , . , , , . , ? . , ? .



    . .


C'est un défi inattendu et sérieux. Il peut sembler qu'il n'y a rien de compliqué lorsque l'auteur est dans le sujet - laissez-le s'asseoir et expliquer. Mais précisément parce que l'auteur connaît bien le sujet, il expliquera quelque chose avec des exemples qui nécessitent une explication séparée.



Cependant, lorsque l'auteur réussit à choisir l'analogie correcte (et compréhensible!), C'est une raison de joie séparée et orageuse.



Voici quelques exemples supplémentaires de la façon dont nous expliquons des concepts complexes:



  • Nous expliquons la conversion en utilisant l'exemple des tartes mangées par les petits-enfants:





  • des événements opposés à la théorie des probabilités - par exemple, l'achat d'un film dans un cinéma en ligne:





  • , , . , , ;
  • for : , , :





  • «» Python, - , .




Chaque auteur a son propre style et nous essayons de le garder. Dans l'environnement de l'entreprise, le concept de la mort de l'auteur est populaire. Son idée est la suivante: l'auteur ne doit pas être visible dans le matériau fini. L'essentiel est de transmettre le sens, les faits et l'expérience. De plus, l'éditeur rendra le texte aussi impersonnel et vérifié que possible.



Nous ne sommes pas d'accord avec ce concept. Il nous semble que cela détruit notre format de présentation. Oui, nous avons des éditeurs, avec les méthodologistes, ils révisent les textes des auteurs, les corrigent et se mettent à la place des étudiants. En même temps, l'auteur peut plaisanter d'une manière particulière dans le cadre de ses idées sur la beauté. Si cela ne nuit pas au sens, les éditeurs laissent de telles choses dans le texte.



Les auteurs réfléchissent aux liens internes des étapes, aux noms des modules, aux liens avec les événements de narration, et bien plus encore. Les rédacteurs s'assurent que le programme de cours devient progressivement plus complexe, sans sauts brusques. L'animateur peut suggérer de transférer les informations vers des documents supplémentaires afin de ne pas surcharger l'élève au tout début.



Le texte erre d'avant en arrière jusqu'à ce qu'il devienne suffisamment informatif et sans ambiguïté, mais la soumission de l'auteur n'en disparaît pas.



Comment les développeurs deviennent auteurs



Les gens viennent à la paternité de différentes manières et de différentes spécialités. Il serait logique que ceux qui ont déjà écrit des articles ou des leçons viennent à nous, mais il y a pas mal de candidats de ce type. Le plus souvent, les auteurs sont des développeurs qui s'intéressent au domaine de l'éducation et qui souhaitent partager leurs connaissances avec d'autres. En plus de l'expérience dans un domaine spécifique de la programmation, il est important pour nous que l'auteur soit capable d'écrire et d'expliquer de manière intéressante afin qu'une personne extérieure à l'informatique le comprenne. Il est également important que l'auteur soit capable de faire des analogies précises, de proposer des métaphores, des exemples et des tâches de la pratique.



Voici quelques histoires des auteurs de l'atelier.



Artemy Vereshchinsky, auteur du cours "React developer", responsable du développement de l'interface utilisateur chez JSC "Netris"



Artemy a toujours voulu traiter des interfaces, il a commencé à coder tout en étant encore administrateur système, puis a maîtrisé le développement avec CMS (Wordpress), après quoi il a travaillé avec des marques européennes de l'industrie alimentaire. Ensuite, il y a eu un an et demi de freelance et de mastering design et JS.



A travaillé en tant que développeur frontend pour un distributeur de Razer, Pantone et d'autres sociétés, a fait un LC et un panier. Il a combiné deux rôles et dans une filiale de Rostelecom a maîtrisé le développement full-stack, mis en œuvre, avec l'équipe, un produit de gestion de diffusion vidéo et de surveillance pour les tribunaux mondiaux.



Désormais, Artemy gère une équipe de designers qui créent un système de conception et développent des projets B2G dans le domaine de la vidéosurveillance, rédige le code en guise de façade.

digital- — , , — . , -, . , .



, , .


Sergey Ozerov, auteur du cours "Développeur Web", développeur front-end chez nebenan.de Une



connaissance appelée Sergey pour enseigner aux enfants les bases de la programmation. Auparavant, il a étudié au lycée de physique et de mathématiques, puis dans une université technique de physique, mais la programmation pendant ses études lui a été donnée avec difficulté. Encore une fois, pour tenter de comprendre le sujet, il a décidé de l'expliquer à lui-même, enfant, en mâchant autant que possible tous les termes et définitions.



À l'avenir, cette approche l'a aidé à expliquer non pas la programmation sphérique dans le vide, mais à montrer sur ses doigts où, comment et pour quoi quel code peut être utilisé, quels programmes peuvent être écrits, ce qu'ils font et où ils se produisent en réalité. vie.

Lorsque vous expliquez quelque chose aux enfants, même quelque chose que vous avez passé il y a longtemps et que vous semblez parfaitement connaître, vous commencez à le comprendre encore mieux. Au début, je commençais moi-même à aborder certains sujets, et la préparation de matériel pour les enfants m'a aidé à les maîtriser parfaitement.


Andrey Strogov, responsable du contenu du premier étage de la faculté Web



Andrey a étudié le miel et a étudié la programmation pendant son temps libre. On lui a aussi accidentellement proposé d'enseigner la JS et les bases de la mise en page aux écoliers.



, , . : , , : «, , ». , .



, . , . , computer science , .


Nastya Ragozina, auteur du cours "Développeur Java"



Nastya a travaillé pendant plusieurs années en tant que programmeuse Java dans le segment B2B, mais avec le temps elle s'est désintéressée de cela. Quelques mois après avoir quitté le travail, elle a commencé à chercher des moments de fête liés à l'éducation - elle voulait garder ses propres compétences et elle aimait aussi toujours aider les nouveaux arrivants. Nastya a commencé comme réviseur pour l'un des cours, puis a rédigé plusieurs documents pour le cours.

J'ai réalisé que j'étais prêt à travailler dans ce domaine, et à ce stade j'aimerais en faire mon travail principal. J'ai eu de la chance: c'est à ce moment que l'Atelier a commencé à recruter des auteurs pour le cours Java.


Comment ne pas apporter ses connaissances aux débutants



Dans le processus de travail, nous avons compilé pour nous-mêmes une liste séparée de ce qui doit être évité par tous les moyens.



  1. - .



    , , - . , .
  2. , , , .



    « , , , », — . , , .
  3. .



    . , . « , ...» .
  4. , .



    , . , , , . , , , . .
  5. Expliquez une entité en mentionnant une douzaine d'autres entités. Cette approche est déroutante et prend du temps pour l'étudiant.


Nous écrivons nos cours avec les efforts d'auteurs et d'éditeurs sympas, et les perfectionnons et les améliorons constamment grâce aux commentaires des étudiants et de nos méthodologistes. Si vous aimez notre approche et souhaitez partager votre expérience, nous avons plusieurs postes à pourvoir pour les auteurs .



All Articles