Как сделать гайд — чтобы не получилось путаного текста
Часто на форумах встречаю гайды, которые вроде бы полезные, а читаешь — и глаза разбегаются: много воды, куча скринов без объяснений, непонятная структура. Пытаюсь сам иногда писать инструкции — и всегда ломаю голову, как сделать так, чтобы не надоедало листать, и чтобы всё было понятно сразу.
Кто работал с этим на практике? Интересует именно реальный опыт, а не общая теория.
Я тут только начал тоже писать гайды, и для меня помогло просто разбивать текст на маленькие куски и писать короткими предложениями. Скрины лучше делать только там, где без них совсем непонятно — иначе глаза устают. Главное, чтобы сразу было видно, что сделать и зачем, тогда читать не надоест.
Мне помогал такой подход: пишешь сначала простой черновик, как будто объясняешь другу, потом проходишься и выбираешь только нужное, убираешь все "воды". Скрины — да, только к ключевым моментам, где текст не хватает. И ещё: лучше не делать текст сплошной стеной, а разбивать на шаги и небольшие абзацы, чтобы глаз отдыхал. Так читателю проще и быстрее понять суть.