Как писать классные тексты
2026-02-26 20:14 Diff
https://ru.hexlet.io/courses/awesome-text/lessons/tone-of-voice/theory_unit

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

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

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

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

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

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">. Этот тег мы используем для ввода ключевых слов веб-сайта. Если вы правильно подберете ключевые слова для этого метатега, то ваш сайт будет выше располагаться в результатах поиска поисковых машин

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

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

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

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

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

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

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

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

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