Как составить туториал

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

Как писать

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

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

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

Не ок

Как настроить Homebridge

В наше время широко распространены умные устройства. Наверное, в каждом доме есть хоть один смарт-девайс. Они все в целом достаточно дорогие, но те, что несут на своей упаковке значок Homekit — особенно. Они сертифицированны компанией Apple и их не всегда можно найти в российской рознице. Именно поэтому несколько лет назад один гениальный программист решил сделать из Raspberry Pi мост, который смог бы сэкономить вам деньги. То есть стал бы поддерживать работу несертифицированных устройств, например всем известного китайского гиганта Xiaomi.

Ок

Как настроить Homebridge и добавить несертифицированные устройства в умный дом Apple

Homebridge — устройство на базе Raspberry Pi. Оно может подружить Apple Homekit и большинство умных устройств, которые Apple официально не поддерживает.

Вот что вам понадобится:

  • Raspberry Pi (минимально — Zero W).

  • Карта памяти от 8 ГБ и выше.

  • SSH-клиент на смартфоне или компьютере.

Устанавливаем Raspbian

Сначала нужно установить на Raspberry Pi версию Debian — она называется Raspbian…


О чем писать

Туториал может быть о чем угодно — всегда найдутся те, кому он поможет. Но прежде чем браться за написание руководства, поищите: не писал ли об этой теме до вас кто-то другой?

  • Как настроить оборудование

  • Как настроить софт

  • DIY-решения

  • Как написать приложение

  • Как начать изучать язык программирования

  • Как пройти игру

  • Как освоить новый инструмент

  • Как написать полезный пост

Это все туториалы.