Скриншоты в инструкции устаревают быстрее текста.

Скриншоты в инструкции устаревают быстрее текста.

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

Отсюда несколько правил для документации, которую придётся поддерживать:

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

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

Хорошая инструкция — та, где снимков ровно столько, сколько вы готовы перерисовать при следующем обновлении интерфейса.