Пиши, сокращай Как создавать сильный текст

Дидактика - это дисциплина, которая изучает принципы обучения. Она помогает структурировать обучение так, чтобы слушатели всё поняли и смогли применить знания в жизни. Желательно, чтобы вдобавок им было еще и интересно.

Вот пример. Читателю захотелось разобраться в любительских микроконтроллерах. Он открывает статью в интернете:

Микроконтроллеры для любителей

Для начала надо понять. какого рода микроконтроллеры вас интересуют и для каких задач. Микроконтроллеры бывают в виде чипа (обычно семейства AVR). в виде платы с выводами (например, Arduino) и в виде полноценного микрокомпьютера с полным набором портов и интерфейсов (например, Raspberry Pi). Каждый подходит для своих задач.

Автор этого текста явно разбирается в теме, и у него есть чему научиться. Но новичкам будет трудно читать его объяснение, потому что он не учел принципов дидактики.

Заставить себя слушать. Внимание и интерес

Читатели заняты своими делами и не думают о вас. Когда вы предлагаете им статью с новой информацией, они не сразу поймут, о чём речь. Сначала нужно настроиться.

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

Представьте елочную гирлянду с лампочками. Это простое устройство: ток из розетки проходит по лампочкам, они светятся.

Простые модели гирлянд просто светятся ровным светом. Но есть такие, которые переливаются. Есть даже такие, которые умеют переливаться с разной частотой, как будто ими что-то управляет.

Ими действительно управляет специальное устройство - оно называется контроллером.

Если вы не в первый раз встречаетесь с читателем по этой теме, напомните, о чём говорили раньше:

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

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

Так и есть: ими управляет специальное устройство - контроллер.

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

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

Чтобы создать стимул, покажите, какую пользу человек получит от статьи:

В этой статье расскажу, какие бывают микроконтроллеры и какой выбрать, чтобы собрать свой первый проект.

Попробуем на других примерах:

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

В школе умели создать интерес: Сегодня вы узнаете, что такое синус. Он обязательно будет у вас в ЕГЭ. Разумеется, это шутка: мотивировать низким баллом по ЕГЭ - дурной тон. Но если бы мне в школе объяснили как-то так, я бы включился на сто процентов:

Знаете игру «Арканоид»? Где шарик летает по полю и всё разбивает. Кажется, что такое легко сделать на компьютере. Но есть проблема: компьютер не умеет перемещать предметы по диагонали. Нет такой команды. Чтобы шарик полетел по диагонали, компьютер должен знать угол падения и посчитать из этого угла синус и косинус. Давайте посмотрим, что это такое ...

Познакомить с предметом

Предмет статьи - это то, о чем пойдет речь. В статье о микроконтроллерах предмет - микроконтроллер. В статье о выборе электронных барабанов предмет - электронные барабаны.

Если предмет новый для читателя, обязательно объясните, что это такое. Не пожалейте времени и сил, чтобы читатель представил этот предмет:

Контроллер - электронное устройство, которое управляет другими устройствами - роботами, гирляндами, микроволновками... Например, у робота могут быть колеса, датчики, манипуляторы и приводы, и всеми ими будет управлять контроллер. Можно сказать, что контроллер - это мозг электронного устройства.

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