warn-before-the-thing-you-are-warning-about
Предупреждение, помещённое после действия, к которому оно относится, приходит, когда читатель уже принял решение. Ставьте его выше и делайте неотклоняемым, когда это важно.
Присвоено человеком, который прочитал карточку, а не заявлено файлом о самом себе. Карточка, которую агент выводит во время запуска, поглотившего недоверенное содержимое, рождается заражённой и удерживается на разбор, прежде чем её вообще извлекут.
Когда это вспоминается
- пишу страницу загрузки
- добавляю разрушительное действие
- описываю грабли
- куда поместить предупреждение
Ценность обычно лежит в разделах «Избегать» и «Проверить». «Делать» — это раздел, который пишут все.
Текст карточки выше — перевод. Английский оригинал — это то, что импортирует командная строка, что читает агент во время работы и что подтверждает хеш ниже.
Повод
У того, что пользователь вот-вот сделает, есть последствие, которого он не ждёт: неподписанный установщик, который заблокирует его ОС; команда, переписывающая историю; настройка, убирающая человека из контура; экспорт, выносящий данные из песочницы.
Это не относится к последствиям, очевидным из подписи. «Удалить» не нуждается в абзаце о том, что оно удаляет.
Делать
- Ставьте предостережение выше элемента управления, в порядке чтения, а не ниже и не в тултипе.
- Говорите, что произойдёт, в терминах пользователя — точный текст диалога, который он увидит, точную ошибку, — и затем что с этим делать.
- Прерывание берегите для необратимого. Подтверждение на сужающем действии приучает прокликивать то подтверждение, которое имеет значение.
- Если неожиданность неизбежна и безобидна, объясните, почему так происходит. «Сертификата подписи кода нет» превращает пугающий диалог в ожидаемый.
Избегать
Предупреждения после кнопки, предупреждения в свёрнутом блоке и предупреждения, которые пользователь может закрыть до того, как столкнётся с ситуацией. Все три — один и тот же сбой: информация приходит после решения.
Избегайте расплывчатости, звучащей ответственно. «Используйте с осторожностью» не сообщает читателю ничего, на чём он мог бы действовать, и настоящая её функция — защитить автора, а не пользователя.
Избегайте предупреждений обо всём. Страница, где помечено пять вещей, не пометила ни одной, и единственная действительно опасная теперь замаскирована.
Проверить
Прочтите страницу сверху вниз как человек, который её никогда не видел, и остановитесь в тот момент, когда нажали бы. Было ли предостережение выше этой точки?
Затем обратная проверка: посчитайте предупреждения на поверхности. Если заметных больше одного, решите, какое настоящее, и понизьте остальные.
Риск
Вынесение предостережений вперёд делает страницу тяжелее и может отпугнуть пользователя, для которого риск никогда не был реальным. Эта цена настоящая, и платить её стоит только там, где неожиданность настоящая.
Сбой от избыточного применения — продукт, который читается как нервничающий сам о себе. Если каждый экран открывается дисклеймером, дисклеймеры становятся хромом и читатель их пропускает, — а это возвращает вас туда, откуда начали, только с текстом похуже.
Как применить
Карточка — это данные. Склонируйте репозиторий и импортируйте её по пути: всё, что приходит по сети, считается заражённым и удерживается до одобрения — это и есть желаемое поведение, и поэтому здесь нет установщика в одну строку.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/warn-before-the-thing-you-are-warning-about/SKILL.mdЦелостность
SHA-256 файла в опубликованном виде. Импортёр может проверить, что полученное совпадает с показанным на этой странице.
6406dae5aafa466bdccc3cea9496b6beb40fee9c87b13da623f55e07fc526182