Материал: lesswrite

Другой способ добавить практики - рассказать случай из жизни,

реальный или выдуманный. Вот теория:

В качестве первого контроллера советуем выбрать оригинальные платы, а не

китайскую ко пи ю - даже не смотря на высокую цену.

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

Мой первый контроллер был оригинальным итальянским Arduiпo за 1500

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

Следующие контроллеры я заказывал в Китае за 200-300 рублей.

Всякий раз с ними было что-то не так и их приходилось перепрошивать через оригинальный Arduiпo.

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

которые вам нужны для объяснения теории:

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

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

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

приводить примеры.

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

290

Помочь с трудностями

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

нужно еще и написать, как бывает:

Если будете заказывать контроллер на китайском рынке вроде «Таобао» или

«Алиэкспресса», заказывайте сразу два контроллера у разных поставщиков.

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

При первой прошивке китайского Arduiпo вы можете получить сообщение,

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

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

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

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

291

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

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

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

Если вы занимаетесь в спортзале, готовьте протеиновый коктейль с творогом и молоком.

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

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

«Как должно быть правильно в идеальном мире».

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

292

Помочь структурой и выводами

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

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

Обратите внимание, как поданы параграфы этой книги: они разделены на небольшие блоки на один, два или три разворота, у

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

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

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

Постарайтесь сформулировать каждый пункт шпаргалки емко,

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

293