Инструкции для чайников (часть 2) 5. Картинки — это база. Даже если вы работаете в консоли, они могут быть полезны, но если вы работаете в графическом интерфейсе — они просто необходимы. Не скупитесь на скриншоты, причём, разрисованные. Не "нажмите на кнопку рестарта приложения", а "нажмите на кнопку Reboot (1) для рестарта приложения", где помимо текста у вас есть скриншот, где искомая кнопка обведена, а рядом с ней стоит цифра 1. Если вы обводите какие-то поля, можете делать это разным цветом, а в инструкции выделять названия разных типов полей соответствующим цветом, это очень наглядно и понятно. Так что не просто прикладывайте скриншоты, а ещё и выделяйте на них важное. 6. Всё на одной странице. Не заставляйте человека бегать по куче мест. Если по инструкции нужно перейти на сайт, оставьте гиперссылку на него, если на сервер, укажите его адрес, если подробности указаны в другой инструкции, то встройте её в вашу под спойлером, так вы сильно увеличиваете удобство работы с вашим гайдом, создавая сервис одного окна. Финальный Глобальный Совет — будьте готовы к апгрейду вашего творения по итогам обратной связи от тех людей, для кого оно было предназначено. Как бы вы ни пытались расписать всё возможное, вы всё ещё остаётесь подвержены ловушке "ну это же очевидно", поэтому почти всегда после первой пробы вскроются какие-то недостаточно прозрачные моменты для других людей или ситуации, про которые вы забыли или они даже при вас ещё не возникали, всё это нужно будет дописывать в инструкцию, поэтому только непрерывное развитие приблизит вас к идеалу. Опять же, здесь речь не только про айтишку. Умение писать гайды полезно везде, где в принципе есть необходимость в письменной форме объяснить, как что-то сделать. Сайт WikiHow тому доказательство, там инструкции по всем сферам жизни. И, между прочим, руководства в нём являют собой прекрасный образец тех советов, которые я описал. Это хороший наглядный пример, на который вы можете ориентироваться.