Как профессионально аннотировать скриншоты: Полное руководство

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

Большинство людей плохо используют аннотации к скриншотам — не потому, что у них нет инструментов, а потому, что никто не научил их принципам. Это руководство охватывает методы, которые делают аннотированные скриншоты по-настоящему эффективными, используя Maxisnap в качестве примера инструмента (хотя принципы применимы к любому программному обеспечению для аннотаций).

Главное Правило: Одна Мысль на Скриншот

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

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

Стрелки: Направляйте Внимание, Не Украшайте

Стрелки — это самый используемый — и самый неправильно используемый — инструмент аннотации. Вот как их правильно использовать:

Направляйте от пустого пространства к цели. Стрелка должна начинаться в относительно пустой области скриншота и заканчиваться на элементе, который вы хотите, чтобы зритель заметил. Если стрелка начинается поверх других элементов пользовательского интерфейса, это создает визуальный шум вместо ясности.
Используйте одну стрелку на скриншот. Если вам нужно несколько стрелок, вам, вероятно, нужно несколько скриншотов. Две стрелки допустимы в некоторых случаях (например, для показа «до/после»), но три или более почти всегда означают, что скриншот перегружен информацией.
Используйте контрастный цвет. Красный или ярко-оранжевый на большинстве фонов пользовательского интерфейса. Белый или желтый на темных интерфейсах. Стрелка должна быть сразу видна без поиска.
Держите стрелки короткими. Длинная стрелка через весь скриншот воспринимается как декоративная, а не направляющая. Делайте стрелки лаконичными — они должны преодолевать короткое расстояние от пустого пространства до цели.

В Maxisnap выберите инструмент «Стрелка», выберите цвет (красный по умолчанию не просто так) и нарисуйте стрелку от пустого пространства к вашей цели. Стиль наконечника стрелки и толщину можно настроить, но значения по умолчанию подходят для большинства случаев.

Текстовые Метки: Краткие, Контекстные, Расположенные

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

По возможности размещайте текст в одну строку. «Нажмите здесь, чтобы сохранить» лучше, чем «Вам нужно нажать кнопку сохранения, которая находится в правом верхнем углу диалогового окна». Краткость экономит время читателя и делает аннотацию аккуратной.
Располагайте текст рядом (не на) с целью. Размещайте текстовые метки рядом с описываемым элементом, с четкой визуальной связью (близость или соединительная стрелка). Не накладывайте текст поверх элемента — это скроет то, что вы пытаетесь показать.
Используйте читаемый размер шрифта. Слишком маленький — теряется. Слишком большой — доминирует над скриншотом. Большинство инструментов для аннотаций по умолчанию используют разумный размер — доверяйте настройкам по умолчанию, если у вас нет веской причины их изменить.
Добавьте фон к тексту. Maxisnap и большинство инструментов позволяют добавлять полупрозрачный фон за текстовыми метками. Используйте его. Текст без фона может быть невидимым на загруженных пользовательских интерфейсах.

Размытие и сокрытие данных: Конфиденциальность — это не опция

Если ваш скриншот содержит что-либо из перечисленного ниже, вы должны скрыть это перед публикацией:

Имена или адреса электронной почты реальных людей (если они не дали согласия)
Ключи API, пароли, токены или учетные данные
Финансовая информация (номера счетов, остатки, детали транзакций)
Персональные данные (номера телефонов, адреса, идентификационные номера)
Внутренние URL-адреса систем, IP-адреса или детали инфраструктуры

Используйте размытия, а не сплошной прямоугольник. Сплошной прямоугольник поверх конфиденциальных данных кричит «здесь что-то скрыто» и вызывает любопытство. Размытие сообщает: «это содержимое не имеет отношения к тому, что я вам показываю», и зритель переходит дальше.

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

Нумерованные шаги: Суперсила документации

Когда вам нужно показать последовательность действий — «нажмите здесь, затем введите это, затем нажмите то» — нумерованные аннотации шагов превращают серию скриншотов в четкую процедуру.

Размещайте номера в точке взаимодействия. Номер должен располагаться непосредственно на кнопке, поле или элементе, с которым пользователю необходимо взаимодействовать, или сразу рядом с ним.
Используйте последовательную нумерацию для всех скриншотов. Если шаг 1 находится на скриншоте A, а шаг 2 — на скриншоте B, читатель естественным образом следует последовательности. Не начинайте нумерацию заново на каждом скриншоте, если только шаги не являются независимыми.
Ограничьте последовательность 5-7 шагами. Если процедура содержит больше шагов, разделите ее на разделы. «Часть 1: Настройка» и «Часть 2: Конфигурация» усваиваются легче, чем пятнадцать пронумерованных шагов на восьми скриншотах.

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

Прямоугольники и выделения: Обводите, не заполняйте

Прямоугольники — это второй по распространенности тип аннотаций после стрелок. Используйте их для выделения области интереса:

Используйте контурные прямоугольники, а не залитые. Залитый прямоугольник скрывает содержимое. Контурный прямоугольник привлекает к нему внимание. Лучше всего работают красные или оранжевые контуры шириной 2-3 пикселя.
Кадрируйте плотно. Прямоугольник должен плотно облегать интересующий элемент. Свободный прямоугольник, включающий много окружающего пользовательского интерфейса, рассеивает внимание.
Комбинируйте со стрелками для сложных пользовательских интерфейсов. На загруженных интерфейсах прямоугольник обрамляет общую область, а стрелка указывает на конкретный элемент внутри этой области. Такой двухуровневый подход хорошо работает для плотных административных панелей и страниц настроек.

Выбор цвета

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

Красный: Основное внимание. Используйте для главного элемента скриншота — стрелки, прямоугольника, элемента "посмотрите сюда".
Синий или зеленый: Второстепенная информация. Используйте для дополнительных меток или контекста, который поддерживает основную мысль, не отвлекая внимания.
Желтый/оранжевый: Предупреждения или важные примечания. Используйте экономно для аннотаций "будьте осторожны" или "обратите внимание".
Белый: Используйте на темных интерфейсах, где красный цвет плохо контрастирует.

Не используйте более двух цветов на скриншоте. Один — идеальный вариант. Два — максимум для ясности.

Кадрирование: Показывайте меньше, сообщайте больше

Прежде чем аннотировать, кадрируйте. Удалите со скриншота все, что не относится к вашей мысли. Полноэкранный снимок экрана 2560x1440, где релевантный элемент — это кнопка 200x100 в одном углу, тратит время и внимание зрителя.

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

Распространенные ошибки, которых следует избегать

Стрелка, указывающая ни на что конкретное. Каждая стрелка должна заканчиваться на конкретном элементе — кнопке, поле, пункте меню. Стрелки, указывающие на общую область, бесполезны.
Слишком много аннотаций. Если ваш скриншот выглядит как доска заговора с нитями, соединяющими все, начните заново с нескольких сфокусированных скриншотов.
Мелкий текст на больших скриншотах. Если зрителю нужно увеличивать масштаб, чтобы прочитать вашу аннотацию, либо кадрируйте более агрессивно, либо увеличьте размер текста.
Забыли отредактировать. Один утечка ключа API на скриншоте может стоить часов или долларов. Сначала редактируйте, потом аннотируйте.
Использование инструмента "Перо" для прямых линий. Инструмент "Перо" для произвольного рисования создает неровные линии, которые выглядят непрофессионально. Используйте инструмент "Стрелка" или "Линия" для прямых аннотаций, а "Перо" оставьте для кругов или знаков выделения, где неровность допустима.

Как Аннотировать Скриншоты Как Профессионал: Полное Руководство