Как написать понятную инструкцию: пошаговое руководство

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

Руководство — прекрасный пример контент-маркетинга. Оно не только показывает вашу экспертность, но и несет огромную пользу людям.

Я разделяю гайды на 2 типа:

• Полное руководство — описывает сервис или какой-то процесс целиком. Например, создание сообщества Вконтакте — от начала и до конца.

• «Как-руководство» — дает ответ на конкретный вопрос. Как создать маркированный список в Google Docs, как сварить борщ, как вкрутить лампочку и т. д.

Любую инструкцию я собираю по одной и той же схеме — она же карта этой статьи:

1. Понять, кто читатель — новичок или спец.
2. Определиться с форматом: полное руководство или «как-руководство».
3. Собрать материал и накидать структуру.
4. Написать черновик коротко и без воды.
5. Проиллюстрировать: скриншоты, гифки, фото результата.
6. Дать почитать человеку из ЦА и посмотреть, где он спотыкается.

Дальше по каждому шагу подробнее.

Узнайте, кто ваша ЦА

Для начала подумайте, кто будет читать ваш гайд? Зеленый новичок, который никогда раньше не делал ничего подобного? Или человек, который уже что-то умеет, но хочет узнать еще больше?

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

Руководство для котов, например

Но, если вы пишите руководство для специалистов, очевидную информацию можно смело опускать. Например, интернет-маркетологи, вероятно, понимают, чем CTR отличается от CTA — им не надо этого объяснять.

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

Пишите кратко и по делу

Вода портит любой текст. Но руководства в ней просто тонут. Ни один человек не будет пытаться выискивать что-то полезное среди «на сегодняшний день» и «все мы знаем». Не надо этого.

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

Начните сразу с сути. Вот пример отвратительного вступления:

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

А вот хороший, годный первый абзац:

В руководстве я собрал 11 методов рисования кругов в Фотошопе. Гайд подходит для любой свежей версии.

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

А где само руководство то? Видимо, на дне морском…

Ищите баланс между лаконичностью и подробностью.

Черновик и структуру сейчас удобно накидывать в ChatGPT или Claude — я так и делаю сам. Но потом всё равно редактирую руками: нейронка льёт воду, а инструкция воды не терпит.

Подберите стиль текста

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

Пишете гайд по Dota 2? Смело пихайте в него сленг! Почитайте форумы и другие гайды, посмотрите пару видео, разберитесь в терминах — и вперед.

Ничего не понятно? А вот для ЦА текста — самое оно

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

Ни в коем случае этого не делайте. Так вы нанесете непоправимый ущерб.

Сделаете так — будет полная жопа.

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

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

Не забывайте структурировать контент

Во-первых, забудьте про длинные абзацы. Если абзац занимает больше 6 строк — разбивайте его на 2. Читать сразу станет легче.

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

Хорошо отформатированный текст и читать приятно

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

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

Если вам нужно что-то сравнить — рисуйте таблицы.

Иллюстрации — наше все

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

Как бы круто вы ни писали — лучше все же показать. Нужно вам, чтобы человек нажал на четвертую слева маленькую красную кнопку в нижнем углублении на правой панели вашего прибора? Ну так сделайте фотографию и выделите эту кнопку стрелкой.

А теперь попробуйте это объяснить без картинок

Если нет фотографий — постарайтесь найти видео на YouTube и вырежьте из него нужные кадры. Или нарисуйте схему в графическом редакторе — тоже отличный способ наглядно что-то показать.

И вообще инструкция не обязана быть только текстом. Один и тот же материал часто заходит лучше в другом формате: инфографика, чек-лист, скринкаст, видеоверсия на YouTube. Читатели разные — кто-то хочет читать, кто-то смотреть, кто-то распечатать и повесить над столом.

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

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

Я для скриншотов использую программу LightShot. Альтернатив хватает: ShareX, CleanShot X, встроенные скриншоты в Windows и macOS. Берите то, что под рукой — во всех можно выбрать область, накидать стрелки и рамки и сохранить в PNG.

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

Гифки — это круто!

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

Подробнее о создании гифок читайте на сайте Texterra.

Можно пойти еще дальше — и снять видеогайд. Он станет прекрасной альтернативой текстовому руководству. Хочешь читать инструкции — пожалуйста. Хочешь посмотреть видео — вот оно.

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

Я немного режу по дереву и мог бы написать клевый гайд об этом

Ссылки в инструкциях

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

В этом руководстве я дал ссылку на обзор сервисов для создания gif-анимации. Конечно, я мог бы сам описать все эти программы. Даже более подробно, чем в той статье. Но ведь мой гайд не об этом. Не каждый захочет читать про гифки. Кому-то оно неинтересно, кто-то уже умеет. Ссылка — оптимальный вариант. Хочешь — переходи и читай, не хочешь — листай дальше.

Кому надо, тот перейдет и прочитает

Это работает еще круче, если у вас есть сайт с кучей руководств. Например, нужно написать серию текстов о командной строке Windows. Конечно, вы можете писать, как открывать эту несчастную командную строку в каждом гайде. А можете вынести процесс в отдельный мини-гайд, и давать на него ссылку на каждой странице. Это будет круче с точки зрения и SEO, и юзабилити.

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

Руководство от Google

Типичные ошибки в инструкциях

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

• вода во вступлении — три абзаца ни о чём, пока не начнётся суть;
• термины без объяснения там, где аудитория — новички;
• абзацы по десять строк, в которых глаз тонет;
• скриншоты без выделения — куда именно нажимать, читатель гадает сам;
• «нужно осуществить настройку» вместо «нажми на кнопку»;
• инструкцию никто не проверил на живом человеке;
• в конце нет фото или скрина результата — непонятно, к чему мы шли.

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

Проверьте инструкцию на живом человеке

Самый честный тест — дать инструкцию человеку из ЦА и попросить выполнить её по шагам, не задавая вопросов. Всё, где он споткнулся, переспросил или полез гуглить — переписываете. Всё, где сделал молча и правильно — оставляете как есть.

Полчаса такого теста экономят кучу нервов вам и вашим читателям.

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

Заключение

Конечно, такие гайды будут стоить дорого. Вряд ли кто-то за 200 рублей захочет делать десятки скриншотов или фотографий, изучать сленг целевой аудитории и создавать наглядные гифки.

Зато этот контент точно будет работать. Подробное руководство с большой вероятностью попадет в ТОП поисковых систем. Люди будут советовать его друзьям и коллегам, репостить в социальных сетях и добавлять в закладки.

Например, мой гайд по Google Docs собрал уже почти 1500 репостов.

Это огромный плюс к посещаемости и отличное доказательство экспертности

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

Спасибо, что дочитали до конца. Надеюсь, этот гайд поможет вам создавать классный и полезный контент.