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

Контроллеры AVR и Arduino не поддерживают многозадачность, но ее

можно имитировать с помощью программ.

Добавим практический пример, привязанный к реальности:

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

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

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

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

Здесь есть абстракции «оригинальное» и «высокая цена». Разовьем их на примерах из жизни:

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

Следующие контроллеры я заказывал в Китае за 200-300 рублей. Всякий раз с ними было что-то не так и их приходилось перепрошивать через оригинальный Ardurno.

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

Олег решил сэкономить и заказал первый контроллер в Китае...

Маша решила не заказывать копию, а начать с оригинального...

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

К любой теории -практику, пример или случай

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

Если будете заказывать контроллер на китайском рынке вроде «Таобао» или «Алиэкспресса», заказывайте сразу два контроллера у разных поставщиков. Велика вероятность, что один из них придет бракованным.

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

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

Продавцы будут уговаривать вас купить две или три макетные платы - не ведитесь. Одной длинной платы хватит за глаза.

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

Трудности бывают не только технические, но и человеческие. Если вы пишете о похудении и спорте, мало просто сказать: «Питайтесь правильно и делайте зарядку. Это и так все знают. Напишите о том, что мешает следовать таким советам:

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

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

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

Рассказ о подобных трудностях куда полезнее, чем разговоры из серии «Как должно быть правильно в идеальном мире».

Не стесняйтесь проблем. Наоборот, раскройте их

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

В конце каждого фрагмента или в конце всей статьи предложите читателю выводы или краткий конспект всего, что вы прошли.

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

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