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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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