Как делать полезные снимки экрана для отчётов об ошибках на Mac

Снимок неисправного экрана оставляет несколько вопросов: какое действие вызвало проблему, что должно было произойти и повторяется ли она каждый раз? Приложите снимок нужной области и краткое объяснение, чтобы исследующий проблему человек смог её воспроизвести.

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

1. Оставьте в кадре достаточно контекста

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

При воспроизведении проблемы используйте примерные данные. Обрежьте посторонние вкладки и данные учётной записи. Удалите учётные данные и личную информацию с исходного экрана до съёмки; лёгкое размытие не обеспечивает надёжного скрытия текста.

Захват области в Floatie оставляет результат плавающим, пока вы возвращаетесь в приложение и проверяете шаги. Если для объяснения последовательности нужно другое состояние, сделайте отдельный снимок.

2. Отметьте наблюдение и объясните его

Часто достаточно одной стрелки к неисправному элементу. Используйте нумерованные пометки, если читателю нужно следовать порядку действий, а объяснение напишите рядом с вложением. Не закрывайте пометками точный текст ошибки или значение, подтверждающее проблему.

Когда снимок Floatie активен, нажмите ⌘E, чтобы открыть редактор Pro и добавить стрелки, текст или номера. Инструменты описаны на странице редактора.

Если ошибка есть только на изображении, OCR поможет скопировать её текст (на английском). Сверьте скопированный результат с оригиналом, особенно пунктуацию и похожие символы. Добавьте текст ошибки, доступный для поиска, в сам отчёт, а не только в изображение.

3. Добавьте шаблон для воспроизведения

Пример ниже вымышленный; замените его своими наблюдениями.

Тема: Кнопка «Сохранить» остаётся неактивной после ввода названия проекта

Среда:
- Приложение и версия:
- Версия macOS:
- Браузер и версия, если применимо:

Шаги:
1. Откройте новый проект.
2. Введите название.
3. Попробуйте нажать «Сохранить».

Ожидаемый результат: После ввода допустимого названия кнопка становится активной.
Фактический результат: Кнопка остаётся неактивной.
Частота: Проблема воспроизвелась в 3 из 3 попыток.
Вложение: project-save-disabled.png

Укажите фактическое число попыток. Если проблема возникла один раз, так и напишите. Для проблемы с макетом сайта укажите размер окна или масштаб, если они влияют на результат.

4. Выберите снимок экрана или запись

Снимок подойдёт для неверного значения, отсутствующей подписи или нарушенного макета. Короткая запись полезнее, если меню исчезает, страница неожиданно прокручивается или важна последовательность нажатий. Запишите только нужную часть экрана (на английском) и остановите запись, когда поведение будет видно.

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

Попробуйте Floatie для следующего отчёта об ошибке