Зарегистрируйтесь для доступа к 15+ бесплатным курсам по программированию с тренажером

Подача и настроение урока Как писать классные тексты

В образовательном контенте важно не только ясно выражаться, но и поддерживать студента. Взрослому человеку сложно учиться: не хватает времени и мотивации, накапливается усталость от работы и личных дел.

Поэтому важно не только то, что мы рассказываем в уроках, но и то, как мы это делаем. В этом уроке мы разберем эту тему подробнее и выясним, как поддержать мотивацию студентов с помощью текста.

Подавайте термины плавно

Как и о многих других сферах, о программировании невозможно говорить без терминов — специальных слов, которые обозначают конкретные понятия или явления. Но новичкам термины даются сложно: нужно запоминать новые слова, разбираться в определениях.

Посмотрим на таком примере:

POSIX (произносится “позикс”) — набор стандартов переносимого интерфейса операционных систем. Это упрощённое, сленговое название международного стандарта ISO/IEC 9945, одобренного и принятого в 1988 году международной организацией по стандартизации ISO. Основа этого документа — набор стандартов IEEE Std. 1003.1, разрабатываемый совместно Институтом инженеров по электротехнике и электронике IEEE и промышленным консорциумом The Open Group.

Этот отрывок выглядит сложно, в нем много терминов и новой информации. Усвоить столько нового невозможно, поэтому читатель прочтет только самое понятное. Чтобы облегчить себе задачу, мозг отбросит сокращения, синонимы, непонятные слова и цифры.

Из этого определения студент узнает, что:

Позикс — это набор каких-то стандартов операционных систем. Это сленговое название какого-то международного стандарта, одобренного какой-то международной организацией. Его основа — набор каких-то стандартов, разрабатываемый каким-то институтом и какой-то промышленной штукой.

Из этого определения узнает, что позикс — это какой-то крутой стандарт. Это очень неполное определение, в котором не хватает важных компонентов. Студент прочитал сложный абзац, но не узнал ничего важного — мотивация учиться дальше падает.

Чтобы этого не происходило, нужно дозировать информацию и плавно подводить читателя к термину:

Раньше программы переносились только между одинаковыми компьютерами. Операционных систем и современных языков программирования еще не было, поэтому нельзя было написать программу для нескольких платформ одновременно.

Это было не очень удобно, поэтому в конце восьмидесятых появилась идея ввести общий стандарт для всех операционных систем. Так появился POSIX — единый международный стандарт переносимого интерфейса.

Этот текст будет понятнее для читателя, потому что мы прошли от простого к сложному, от знакомого к незнакомому. Сначала студент прочитает описание простыми словами, а только потом увидит сам новый термин.

Не заигрывайте с читателем

В этом курсе мы часто говорим, что нужно разговаривать со студентом неформально, не перегружать его терминами, объяснять попроще, заботиться и вести за руку по сложным темам. Но всегда есть риск переборщить:

Оказывается, что str — это никакая не функция, преобразующая все в строку! По секрету скажу, что это самый что ни на есть настоящий класс, хоть и прикидывается функцией! Прикиньте, как все неоднозначно!

К счастью, вне стандартной библиотеки такими приемчиками не злоупотребляют. Так что без паники, все таки обычно большинство классов таки можно узнать по имени 😎

Такая веселая подача подходит для статей или развлекательных постов, но в образовательном контенте она не работает. Эти шутливые формулировки отвлекают от сути, поэтому студенту сложнее запоминать такую мысль. В итоге студент сомневается в пользе курса, и мотивация снижается.

Не давайте оценочные суждения

Оценочные суждения допустимы там, где основная цель текста — донести свое мнение:

  • В статье с рассуждением о какой-то технологии

  • В посте в блоге, где вы делитесь личным опытом

  • В комментариях

  • В книге, если вы описываете свою авторскую методику

А вот в курсе такие размышления будут не очень уместны. Дело в том, что студент привыкает к тому, что автор курса — опытный эксперт, признанный специалист и виртуальный наставник. Такой человек не может ошибаться, поэтому все его слова надо воспринимать всерьез.

Посмотрите на этот пример из введения к уроку в середине курса:

Мы все хорошо знаем императивную и декларативную парадигмы программирования. Уже меньше людей слышали об автоматном программировании. Еще меньше слышали о логическом программировании, а имели с ним дело вообще единицы. Если все так грустно, значит ли это, что логическое программирование просто никому не нужно?

Студент может воспринять эту мысль как объективный факт — и начнет заблуждаться, ведь здесь нет никаких ссылок на доказательства. На самом деле эта мысль — оценочное суждение, основанное только на личном опыте. Такие переключения подрывают доверие студента, потому что подают субъективные мысли как реальные факты.

Избегайте негатива

Продолжим работать с примером из предыдущего блока. В конце этого абзаца идет такое предложение:

Мы все хорошо знаем императивную и декларативную парадигмы программирования. Уже меньше людей слышали об автоматном программировании. Еще меньше слышали о логическом программировании, а имели с ним дело вообще единицы. Если все так грустно, значит ли это, что логическое программирование просто никому не нужно?

Автор делает вывод, что ситуация с парадигмами грустная. Это также подрывает доверие, добавляет негатив и снижает мотивацию студента. У читателя может возникнуть логичный вопрос: «А зачем мне учиться чему-то плохому, неудобному, сложному, неинтересному, грустному?».

Здесь есть еще одна проблема. Это рассуждение звучит так, как будто автор недоволен своей профессией: ему приходится работать с неудобными технологиями и скучными языками, общаться с некомпетентными коллегами, «единицы из которых хотя бы слышали о логическом программировании». Вряд ли такой тон урока добавить мотивации студенту.

Вставайте на сторону читателя

Часто техническая документация пишется обезличенными формулировками:

Ниже приведен список самых важных метатегов:

  • <meta name="description" content="content"> — применяется для краткого описания содержания документа. Этот текст отображается в описании веб-сайта поисковыми машинами

  • <meta name="keywords" content="content"> — применяется для ввода ключевых слов веб-сайта. Применение этого метатега позволяет добиться лучшего расположения веб-сайта в результатах поиска поисковых машин

Обратите внимание, что в тексте нет действующих лиц — автор пассивно наблюдает за каким-то объектом и описывает его.

В отличие от документации, уроки пишутся из более активной позиции. Студент должен не только пронаблюдать что-то новое, но и научиться работать с этим новым. Автору урока нужно помочь новичку разобраться.

Представьте растерянных новичков, которым сложно воспринимать документацию. Поможем им разобраться, формулируя мысли через местоимение «мы» и советы в формате:

Давайте изучим список самых важных метатегов:

  • <meta name="description" content="content">. Такой тег мы применяем, когда нужно кратко описать содержание документа. Вы можете использовать этот тег, если нужно добавить текст в описании сайта для поисковых машин

  • <meta name="keywords" content="content">. Этот тег мы используем для ввода ключевых слов веб-сайта. Если вы правильно подберете ключевые слова для этого метатега, то ваш сайт будет выше располагаться в результатах поиска поисковых машин

Обратите внимание, как поменялся тон второго текста. Кажется, что здесь опытный наставник пытается объяснить новичку, как работает та или иная технология. В этом фрагменте автор и читатель — не просто пассивные наблюдатели, а активные участники процесса.

Сравните, как звучит одна и та же мысль с разными местоимениями:

Местоимение

Пример

Мысли студента

Без местоимения

В этом уроке разбирается, как работать с бинарным поиском

Слишком формально, как будто у урока нет автора. Я наедине со сложной темой

Я

В этом уроке я расскажу, как работать с бинарным поиском

Автор делится личным опытом или своим уникальным подходом, а не рассказывает общепринятые правила. Это бесполезно

Мы

В этом уроке мы разберемся, как работать с бинарным поиском

Я разберусь вместе с автором. Он поделится общепринятыми правилами, а я научусь на его опыте. Вместе мы справимся

Ты

В этом уроке ты разберешься, как работать с бинарным поиском

А вдруг у меня не получится? Если я не справлюсь, никто не поможет. Я наедине со сложной темой

Вы

В этом уроке вы разберетесь, как работать с бинарным поиском

Автор уважительно обращается ко мне или к группе студентов. Я буду разбираться один, но одновременно с другими студентами. Если что-то не получится, они смогут подсказать.

Не бойтесь слишком часто говорить «мы», ведь так вы присоединяетесь к студенту. Вы встаете на одну сторону с ним: не поучаете, не требуете, не оставляете наедине с проблемой.

Выводы и практические советы

  • Подавайте термины плавно. Студенту сложно усвоить много нового, поэтому он будет пропускать перегруженные определения. Чтобы этого не происходило, нужно дозировать информацию и плавно подводить читателя к термину: от простого к сложному, от знакомого к незнакомому

  • Не заигрывайте с читателем. Веселая подача в образовательном контенте не работает. Шутливые формулировки отвлекают от сути, поэтому студенту сложнее запоминать такую мысль. В итоге студент сомневается в пользе курса, и мотивация снижается

  • Не давайте оценочные суждения. Студент привыкает к тому, что автор курса — опытный эксперт, признанный специалист и виртуальный наставник. Такой человек не может ошибаться, поэтому все его слова надо воспринимать всерьез. Он может воспринять субъективные рассуждения как объективные факты. Это подрывает доверие к автору

  • Избегайте негатива. Студенты не хотят учиться чему-то плохому, неудобному, сложному, неинтересному или грустному. Вряд ли такой тон урока добавить мотивации

  • Старайтесь избегать безличных формулировок, лучше пишите через «мы» и «вы». Представьте, что вы знакомите читателей с новой технологией и проводите его за руку по новым темам. Такие формулировки поддерживают студента и помогают ему чувствовать себя активным участником обучения


Самостоятельная работа

Изучите этот текст:

В этом уроке раскрывается, как появился интернет и по каким принципам он работает. История интернета не очень интересная и довольно запутанная, но стыдно ее не знать! Вообще интернет появился благодаря военным, которые хотели объединить компьютеры в разных частях страны, чтобы информация совместно вычислялась и передавалась.

Эта задача была выполнена Advanced Research Projects Agency, которая в 1969 году переслала сообщение между ЭВМ двух университетов. Это сообщение прошло аж целых 600 километров и изменило вектор развития технологий.

Проект получил название ARPANet. Сначала сеть использовалась для научных исследований, что ускорило передачу их результатов. Позже это приглянулось другим институтам и компаниям, поэтому к сети в начале восьмидесятых подключились десятки тысяч компьютеров.

С каждым годом число компьютеров увеличивалось, и этим была затруднена работу сети. Поэтому появилась необходимость ее оптимизации.

Одновременно с этим разрабатывалась сеть World Wide Web. WWW называют всемирной паутиной, из-за чего многие не особо собразительные новички думают, что это и есть интернет. Но тут все не так просто! WWW — это часть интернета, одна из его подсетей. Например, созданная сеть для игры с друзьями в доме тоже будет частью интернета.

Во время курса используется понятие интернет, но если речь идет о сайтах, то это о World Wide Web.

Интернет создали, чтобы объединить компьютеры и быстро передавать информацию. Далее в уроке разбирается, как строится сеть из компьютеров, и как информация передается с одного устройства на другое.

Найдите в нем ошибки, которые мы обсуждали в уроке.

Нажмите, чтобы увидеть ответ

В этом уроке встречаются почти все ошибки, которые мы обсуждали в уроке:

Ошибка 1. Подавайте термины плавно. В основном в тексте термины подаются плавно — их много, но они объяснены простыми словами. Чтобы улучшить текст, можно отредактировать это предложение:

Эта задача была выполнена Advanced Research Projects Agency, которая в 1969 году переслала сообщение между ЭВМ двух университетов.

Это предложение можно разделить на несколько небольших, добавить пояснение к названию Advanced Research Projects Agency и заменить «ЭВМ» на «компьютеры». Так студенту будет проще обработать информацию.

Ошибка 2. Заигрывание с читателем. Еще в тексте есть такая фраза:

Но тут все не так просто!

Ее можно смело убрать, потому что она отвлекает студента от темы и не несет информации. Более того, она придает тексту излишне неформальный тон.

Ошибка 3 и 4. Оценочные суждения и негатив. Здесь мы использовали неоднозначные негативные формулировки, которые лучше убрать:

История интернета не очень интересная и довольно запутанная, но стыдно ее не знать!

WWW называют всемирной паутиной, из-за чего многие не особо собразительные новички думают, что это и есть интернет.

Ошибка 5. Автор не на стороне читателя. В этом отрывке мы везде используем только безличные формулировки, которые лучше заменить на фразы с «мы»:

  • Во время курса используется

  • В этом уроке раскрывается

  • Далее в уроке разбирается


Аватары экспертов Хекслета

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно

  • 130 курсов, 2000+ часов теории
  • 1000 практических заданий в браузере
  • 360 000 студентов
Отправляя форму, вы принимаете «Соглашение об обработке персональных данных» и условия «Оферты», а также соглашаетесь с «Условиями использования»

Наши выпускники работают в компаниях:

Логотип компании Альфа Банк
Логотип компании Aviasales
Логотип компании Yandex
Логотип компании Tinkoff

Используйте Хекслет по-максимуму!

  • Задавайте вопросы по уроку
  • Проверяйте знания в квизах
  • Проходите практику прямо в браузере
  • Отслеживайте свой прогресс

Зарегистрируйтесь или войдите в свой аккаунт

Отправляя форму, вы принимаете «Соглашение об обработке персональных данных» и условия «Оферты», а также соглашаетесь с «Условиями использования»
Изображение Тото

Задавайте вопросы, если хотите обсудить теорию или упражнения. Команда поддержки Хекслета и опытные участники сообщества помогут найти ответы и решить задачу