Пиши, сокращай

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

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

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

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

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

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

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

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

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

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

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

Ударные сенсоры (или годы) - это поверхности, по которым барабанщик бьет палочками. Пэды бывают резиновыми и кевларовыми. От того, насколько упругая резина и насколько хорошего качества кевларовая мембрана, зависит отскок палочки и ощущения от игры по году. Сами по себе пэды не звучат.

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

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

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

Сначала показать, потом рассказать

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

Показывать полезно. Иллюстрации в статьях включают внимание, заставляют остановиться и рассмотреть. Когда вы листали эту книгу в свободное время, вы наверняка остановились на этой иллюстрации справа. «Что за микросхемы?» - подумали вы и начали читать текст слева. И вот вы здесь.

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

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

показывает, зачем нужен каждый контроллер;

объясняет их различия;

дает простую шкалу для их сравнения.

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