Пиши, сокращай полностью

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

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

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

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

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

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

Чип AVR

Программируемый чип. Умеет управлять электрокомпонентами: светодиодами, моторами, датчиками и другими чипами. Для простых компактных устройств.

Возможности…

Сложность…

Платформа Arduino на базе чипа AVR

Чип AVR, установленный на плату с удобными выводами и питанием. Много готовых совместимых плат — например, для отправки смс, управлении розетками или роботами. Для обучения и быстрых экспериментов.

Возможности…

Сложность…

Компьютер Raspberry Pi

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

Возможности…

Сложность…

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

Типы поддерживаемых портов для ввода и вывода сигнала сильно влияют на выбор микроконтроллера. В чипах семейства AVR только порты общего назначения (GPIO). Максимум, что они умеют, — широтно-импульсная модуляция сигнала и аналого-цифровое преобразование.

Фрагмент сложный не потому, что в нём объясняются сложные вещи, а потому, что он насыщен новыми терминами, которые объясняются другими новыми терминами.

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

Контроллеры управляют другими частями вашего проекта через специальные контакты — их называют портами.

У чипов AVR простые порты: они умеют подавать ток на одни ножки и принимать ток с других. Это называется «интерфейс общего назначения» или GPIO, General Purpose liiput-Output.

Например, вам нужно зажечь светодиод, подключенный к девятой ножке контроллера. Вы даете команду «Подай ток на девятую ножку». Контроллер подает 5 вольт, ток бежит на светодиод.

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

Второе решение — избавиться от сущностей, которые эти термины обозначают. Посмотрите снова на этот пример:

сильно влияют на выбор микроконтроллера. В чипах семейства AVR только порты общего назначения (GPIO). Максимум, что они умеют, — широтноимпульсная модуляция сигнала и аналого-цифровое преобразование.

Нужно ли нам знать о ШИМ и ЛПЦ, когда мы выбираем первый микроконтроллер для любительского проекта? Кажется, что не нужно. Эта информация здесь необязательная, удалим ее: