Ить об ошибке

Как сообщить, что вы всё уронили: шаблон действий в ситуации, когда всё пошло не по плану

Время на прочтение
7 мин

Количество просмотров 6.6K

Когда всё падает — это нормально. Особенно в IT. Даже Марку Цукербергу периодически приходится извиняться, когда сбой в работе соцсетей приводит к миллиардным потерям. Надеемся, что у вас таких потерь не будет, поэтому поговорили с разработчиками, тимлидами и менеджерами. Спросили, что и как нужно делать, когда всё плохо, чтобы не навредить карьере. 

Почему вообще сообщать об ошибках сложно

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

Так работают наши психологические механизмы. У каждого из нас есть набор представлений о себе, и в этот набор по умолчанию входит установка «я прав». Момент, когда нужно рассказать о неполадках в работе, разрушает эту установку и нам становится неприятно и неловко.

Исследования показывают, что непризнание вины может повысить самооценку.

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

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

Чем быстрее, тем быстрее

Кевин Риггл, специалист по информационной безопасности и консультант, рекомендует сразу определить, в какой из чатов вы сообщите о проблеме. Причём критерием выбора должна быть скорость: люди, которым важно знать о проблеме, должны максимально быстро отреагировать на сообщение. Но оповещение не должно затрагивать ту часть команды, которую не коснутся перебои в работе. 

Это может быть рабочий чат в мессенджере, соцсетях или сообщение на электронную почту, а скорее всего — всё вместе. Главное — оповестить всех членов команды, кого может затронуть инцидент. В Atlassian также рекомендуют использовать специальную Status page или виджеты и пуши, чтобы сообщать об инцидентах клиентам. В крупных компаниях, как правило, такие механизмы уже отработаны, но не факт, что все знают и помнят, как ими пользоваться.

Назовите проблему сразу же

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

Мне совершенно всё равно, как будет сказано, хоть матом. Главное, чтобы сразу же сказали, что и где упало и что с этим делали. Когда случилась проблема, обычно уже не до процедур. Часто начинают паниковать. Но важно уметь спокойно разбираться и чинить, пока тебя дёргают со всех сторон — это отдельный скилл. Он приходит с опытом.

Кира 2Pizza, ведущий разработчик

Антонина Лебединская, бизнес-тренер, эксперт по менеджменту и личной эффективности и преподаватель Нетологии, предлагает использовать самые простые и короткие формулировки. Чем более далека от технической части аудитория, которая получит письмо, тем проще нужно писать. В детали погружаться не нужно вовсе. Если же в деле есть важные детали, лучше дать ссылку на документ или дашборд, где с ними можно ознакомиться. Ничего объяснять для начала тоже не надо: может быть, вы и сами ещё не понимаете, в чём проблема. Тем более не надо оправданий о том, что «оно само». Вообще ничего не нужно, кроме факта.

Добрый день, коллеги.

Сегодня стала недоступна функция Х.

Проявить эмпатию, если это уместно

Этот пункт зависит от того, кому вы сообщаете об ошибке. Как правило, конечным пользователям и клиентам принято сообщать, что вы сожалеете, что поставили их в неловкую ситуацию.

Приносим извинения за этот инцидент. 

Мы понимаем, что эта функция крайне важна для вашей работы в системе. 

Эта формулировка нейтральная и подходит для широкой аудитории: разных клиентов, руководителей, бизнес-отделов, бухгалтерии. 

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

Рассказать, как и когда все исправите 

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

Михаил Корнеев, тимлид, автор YouTube-канала «Хитрый питон»

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

Макс, привет!

У нас случился security-провал, ставлю тебя в известность. У нас xxx, и из-за этого yyy (описание ситуации и вероятных последствий). 

Что делаем, чтобы исправить:

  1. Я запросил у Васи информацию, которая нам поможет информировать NNN.

  2. Завёл тикет, в рамках которого поправим ZZZ.

  3. Договорился с Петей, что теперь в чек листе будет отдельная задача на проверку xxx.

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

Специалисты работают над исправлением ситуации.

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

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

Назначить ответственного

Елена Степанова, разработчик и product owner из Nokia, считает, что нужно назначить человека, который будет координировать весь процесс, пока проблема не решится. Это должен быть сотрудник, который достаточно компетентен, чтобы разобраться с технической проблемой. К тому же, с хорошоими коммуникационными навыками. Если у вас в команде есть проджект-менеджер — то вам повезло, эту ответственность можете смело делегировать ему.

Елена Степанова, разработчик и product owner из Nokia

Внутри команды у нас сообщения предельно прямолинейные и простые: сломали вот это, коллега N занимается анализом, выглядит не очень сложно, починим в течение суток. Главное — указать:

— какие компоненты задействованы и на что влияет поломка

— кто отвечает за решение проблемы 

— какой примерный срок починки

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

Ответственного и его контакт можно и нужно указывать всем, кого коснулась ошибка. Именно этот человек должен собирать обратную связь: репорты о новых багах, отчёты о старых. Кто-то должен аккумулировать всю информацию в одном месте, работать копилкой идей и решений, чтобы координировать информационные потоки. Для этого можно выделить даже отдельный канал в мессенджере.

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

Не искать виноватых

Каждый сбой — это повод проверить, что не так в рабочем процессе. Но нужно чувствовать разницу: искать причину ошибки, а не кого-то, на кого свалить неудачу. Когда инцидент уже произошёл, велик риск начать поиск виноватых, погрязнуть во взаимных обвинениях и конфликте, считает Product Adviser Александр Дученчук. Но это то, чего делать как раз не нужно. Проблему вы решите, а отношения испортятся. 

 Александр Дученчук, Product Adviser 

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

Приходит срок релиза API, бэкенд готов, всё круто. Но! Сайт-то висит старый, со старым бэком, и там сотни тысяч юзеров, и никто не подумал, что мы не сможем релизить продукты с разными и рассинхронизипованными базами. А сроки-то названы, под них подвязан инвестраунд следующий. Перед нами два варианта: либо мы строим синхронизацию между старой и новой базой на время, пока делаем сайт, либо ничего не релизим и уходим в разработку сайта. Приходим к инвесторам, объясняем честно ситуацию, признаёмся, что не спланировали полностью миграцию, предлагаем оба варианта решения. 

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

Мораль сей басни такова: планируйте до конца весь флоу, проговаривайте честно свои ошибки, давайте сразу варианты решений, и если уже ошиблись, то несите ответственность за ошибки и принимайте их спокойно, не ссорясь с заказчиком. Главный тезис — сначала проверяешь, можно ли решить проблему и за какое время. Идёшь и честно объясняешь ситуацию. Никого не винишь, это тоже очень важно, даже если где-то были со стороны заказчика недосказанности.

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

Сообщить, когда всё наладится

Когда все восстановите, обязательно напишите ещё одно письмо — оно будет короче и приятнее. Пишите в те же чаты и тем же адресатам на почту, даже если на первое сообщение никто из них не отреагировал. Схема та же: заголовок с важным фактом, коротко — раскрыть суть.

Функция х снова работает

Добрый день

Работа приложения восстановлена в полном объёме

Если заметите сбои — пишите ххх

Пример большого и подробного письма

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

Тема: Производственный сбой в базе данных

Кластер первичной базы данных перестал отвечать на запросы в 0:02 UTC — 17:02 по тихоокеанскому времени. Через тридцать секунд производство переключилось на вторичную базу данных и предупредило об инциденте. 

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

Я куратор инцидента. Координация через канал отработки отказа # 2021-03-15-production-failover в Slack.

Представитель по связям с клиентами: Джейла М.

Специалисты в данной области: Алисия С., Дэйв Д.

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

Правила написания сообщений об ошибках

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

Правила создания эффективных сообщений об ошибках не меняются вот уже 20 лет. Хорошее сообщение об ошибке должно:

  • Явно указывать, что что-то не так. Самое плохое сообщение об ошибке это то, которое не было создано. Если пользователи делают ошибку и не получают никакого отклика от системы, это самое худшее для них. Например, приложение работы с электронной почтой имеет несколько ситуаций, где указание о произошедшей ошибке было бы явно полезным. Скажем, вы отправили почтовое сообщение, которое было благополучно проглочено системой, но так и не достигло адресата. Еще пример? Вы сообщаете в письме, что прилагаете к нему файл, но просто забыли сделать это. Вот тут-то и нашлась бы работа для этой глупой скрепки из MS Office: «Похоже, вы хотели прикрепить файл к вашему сообщению, но не сделали этого. Хотите сделать это?».
  • Быть написано на человеческом языке, а не с использованием таинственных кодов и сокращений типа » произошла ошибка типа 2″.
  • Быть вежливым и не обвинять пользователей в том, что они такие глупые или сделали что-то не так, как например в сообщении «запрещенная команда».
  • Точно описывать источник проблемы, а не просто выдавать общие фразы типа » синтаксическая ошибка».
  • Давать конструктивный совет о том, как исправить проблему. Например, вместо того, чтобы сообщать о том, что товара » нет в наличии», ваше сообщение об ошибке должно либо сообщать, когда товар будет в наличии, или предлагать пользователям настроить отсылку им сообщения-уведомления, когда товар появится в наличии.

Самая распространенная ошибка в Web — 404 — нарушает большинство из этих правил. Я рекомендую вам написать свое собственное сообщение об ошибке 404 вместо того, чтобы полагаться на скупую серверную фразу «page not found».

Новые правила

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

  • Видимым и очень заметным, как относительно самого сообщения, так и того места, где пользователь должен исправить ошибку.

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

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

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

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

Обучение пользователей

И наконец, вы наверное уже знаетеПервый Закон Нильсена о компьютерной документации: люди ее не читают. Этот закон действует еще сильнее для веб-сайтов, где пользователи действительно избегают читать то, что не существенно для их задачи. Щелкнуть по ссылке «Помощь»? Да ни за что.

Пользователи читают документацию к системе только тогда, когда у них возникает проблема (это Второй закон). Они особенно внимательно ее читают, когда хотят исправить ошибочное действие. В этом случае вы можете использовать сообщения об ошибках в качестве обучающего материала, и подавать в них эти знания малыми порциями. Естественно, сообщения об ошибках должны быть краткими и по делу, как впрочем весь контент веб-сайта. Однако, сообщения об ошибках все-таки могут дать людям крупицы информации о том, как работает система, и подсказать, как с нею лучше работать. И в завершении этой темы, Web вводит еще одно правило:

Отправка сообщений об опечатках в публикациях

Привет, Хабр! Обычно мы не выгружаемся в пятницу, но сегодня особый случий: во-первых, зима уже не так близко, во-вторых — начало весны и день котов, в-третьих — сколько можно тянуть-то с этой долгожданной фичей?!

Заходите под кат, выделяйте кусок публикации и ждите CTRL/CMD+Enter — дальше сами всё поймёте.

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

Алгоритм работы следующий:

1. Выделяете фрагмент текста с ошибкой (любую — грамматическую или пунктуационную, на ваше усмотрение) в публикации;

2. Нажимаем хоткей CTRL+Enter (или CMD+Enter);

3. В нижней части экрана появляется форма, в которой будет процитирован выделенный ранее (в п.1) текст, а также поле для опционального пояснения.

4. Нажимаем «Отправить». Автору публикации формируется письмо (от имени того, кто отправлял опечатку) в личные сообщения, которое выглядит примерно так:

5. Не теряем надежд, что автор оперативно заметит сообщение и исправит присланную опечатку.

  1. Фича работает только в публикациях;
  2. В мобильной версии фичи пока не будет;
  3. Можно выделить хоть всю публикацию, но в цитату влезет только 220 символов, поэтому лучше конкретно указывать слово с опечаткой. В сопровождающем комментарии можно вбить не более 500 символов;
  4. 1 опечатка = 1 сообщение (в диалоге с автором публикации);
  5. Если вы выделяете фрагмент, который кем-то уже был отправлен автору публикации, то вам об этом сообщит уведомление:

Ошибки и описки на сайте

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

Чтобы сообщить об описке или ошибке на сайте, выделите слово или словосочетание и нажмите Ctrl+Enter — появится вот такая форма.

Там цитируется весь абзац (чтобы мне проще было понять, где это), можно дать свой комментарий, но это необязательно.

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

Спасибо всем, кто указывает на описки и ошибки на сайте — вместе мы делаем этот мир лучше.

UX ошибкаСообщения об ошибке — простая на первый взгляд вещь, поэтому обычно им уделяется не очень много внимания. Тем не менее не всякое сообщение об ошибке можно назвать правильным и полезным. Хорошее сообщение должно информировать пользователя о том, что что-то пошло не так, объяснить причину, а также сообщить, как он может решить проблему.

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

Чтобы этого не произошло, при создании сообщения об ошибке вам нужно сделать следующее:

1. Проверить орфографию и пунктуацию

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

Комьюнити теперь в Телеграм

Подпишитесь и будьте в курсе последних IT-новостей

Подписаться

2. Конкретизировать проблему

Будем честны — сообщения вроде «произошла ошибка» или «что-то пошло не так» вряд ли можно назвать полезными. Чтобы они стали таковыми, нужно объяснить пользователям, что конкретно произошло и как конкретно они могут это исправить.

Даже глобальные корпорации не застрахованы от таких неудач. Вот такая ошибка встречалась при установке Windows 10 (и сейчас уже стала мемом):Something happened

На самом деле при такой ошибке требовалось изменить языковые настройки, но из сообщения выше это было, естественно, не очень очевидно :)

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

3. Предоставить достаточное количество информации

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

Тут надо:

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

4. Писать вежливо и в дружелюбном ключе

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

Пример неудачного сообщения об ошибке:Пример неудачного сообщения об ошибке

Пример удачного сообщения:Пример удачного сообщения об ошибке

5. Использовать микротекст

Микротекст — короткий текст-подсказки рядом или под графами, которые помогают понять, как правильно заполнить то или иное поле. Полезный прием, который может сэкономить время и нервы пользователей. Иногда микротекст отображается при наведении курсора на значок справочной информации.Текст-подсказки

6. Можно добавить немного юмора

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

Или другой известный пример (страницы 404 очень часто креативно оформляют):4040 ошибка

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

Попробуйте вспомнить, какие оригинальные и необычные сообщения об ошибках вам выдавали многочисленные программы и приложения, которыми вы пользуетесь. Наверняка у каждого из вас найдётся пара забавных примеров таких сообщений. В моём личном рейтинге на данный момент безусловный лидер — «Метод вернул что-то не то». Если существует шкала информативности сообщений, то приведённый пример по этой шкале стремится к нулю.

Здесь система, по сути, сообщает нам, что произошла ошибка. Больше никакой информации из этого текста мы не получим. Разве что узнаем, что где-то в недрах самой системы существует какой-то метод, который что-то не то вернул. Ценность этого знания для обычного пользователя нулевая.

Можно предположить, что этот текст — артефакт, оставшийся от процесса тестирования очередной функциональности. Некий флаг, оставленный разработчиком на этапе альфа-тестирования. Для программиста он явно имел какой-то смысл, но для обычного пользователя — совершенно бесполезен.

Давайте порассуждаем, каким должно быть идеальное сообщение об ошибке.

5 основных правил

В книге Сьюзан Уэйншенк «100 главных принципов дизайна» приведены основные правила написания информативного и полезного сообщения об ошибке:

  1. Расскажите пользователю, что он сделал.
  2. Объясните проблему.
  3. Объясните, как исправить ошибку.
  4. Используйте активный, а не пассивный залог.
  5. Приведите пример.

В книге есть пример того, как не надо писать сообщения об ошибке:

#402: до того как счёт может быть оплачен, необходимо, чтобы дата платежа была позднее, чем дата создания счёта.

После варианта «Метод вернул что-то не то» даже такое сообщение может показаться довольно информативным. Однако в нём есть что улучшить. Но для начала давайте в порядке эксперимента попробуем его ухудшить — разберёмся, как не надо писать сообщения об ошибках.

А ещё хуже можешь?

«Вы хотите отправить разработчикам отчёт об ошибке в приложении?»
«Ok»
«Ну и ябеда!»

Нам не привыкать — у нас за плечами многолетний опыт общения с разномастными продуктами отечественного софтостроения. Давайте уберём конкретику вовсе:

Счёт не может быть оплачен. Введены неправильные данные.

Чтобы ещё больше запутать пользователя, скроем от него причину ошибки:

Счёт не может быть оплачен.

Теперь приблизимся вплотную к нашему почти нулевому варианту:

Ошибка выполнения метода bill_payment.

Дальше для достижения антиидеала нам остаётся только убрать название метода и творчески преобразовать текст:

Неизвестная ошибка.

Интересно, не возникло ли у вас чувство дежавю, когда вы читали примеры в этом подразделе?

Добавляем информацию

В случае возникновения критической ошибки обновления:
1. Установите причину ошибки.
2. Устраните причину ошибки.
Документация Microsoft

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

Напомню исходный вариант сообщения из книги:


#402: до того как счёт может быть оплачен, необходимо, чтобы дата платежа была позднее, чем дата создания счёта.

Для начала преобразуем исходный текст, чтобы его легче было воспринимать:

#402: Для оплаты счёта необходимо, чтобы дата платежа была позднее, чем дата создания счёта.

Теперь расскажем пользователю, что он сделал не так:

#402: Вы ввели неправильную дату платежа — она раньше, чем дата создания счёта. Для оплаты счёта необходимо, чтобы дата платежа была позднее, чем дата создания счёта.

Выделим суть проблемы в отдельное предложение и явно объясним пользователю, что он должен сделать, чтобы её решить.

#402: Ошибка оплаты счёта. Вы ввели неправильную дату платежа — она раньше, чем дата создания счёта. Измените дату платежа так, чтобы она была позднее даты создания счёта.

Наконец, приведём конкретный пример. В данном случае нам известны даты и мы их можем использовать в тексте:

#402: Ошибка оплаты счёта. Вы ввели неправильную дату платежа 25.07.2021 — она раньше, чем дата создания счёта 29.07.2021. Измените дату платежа так, чтобы она была позднее даты создания счёта 29.07.2021. Например, 30.07.2021.

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

Лучшее сообщение об ошибке

Ошибка выполнения метода: «Метод выполнился без ошибок».

Есть фразы, которые сразу хочется выписать на жёлтый стикер и приклеить где-то рядом с монитором. Одна из таких фраз: «Лучшее сообщение об ошибке — отсутствие сообщения об ошибке». Иными словами, часто бывает проще не допустить возможности возникновения ошибки, чем её описывать.

В нашем примере никто не мешает разработчику сделать две вещи:

  1. При смене даты счёта очистить поле с датой платежа.
  2. В интерфейсе запретить ввод даты платежа позже заданной даты счёта.

Эти незначительные изменения в коде позволят избежать ошибки вовсе. И не нужно будет ломать голову над текстом сообщения.

К сожалению, таким простым способом решить проблему удаётся не всегда. Мы не можем полностью обезопасить приложение от возникновения ошибок. Но в наших силах сделать сообщения об ошибках более информативными и полезными.

А с какими загадочными сообщениями об ошибках сталкивались вы?

Почему сообщения об ошибках имеют значение

Вероятно, все в интернете время от времени встречаются с сообщениями об ошибке. Например, всплывающие окна «Неправильный пароль» или «Не удаётся получить доступ к странице». Такое периодически встречается на любых сайтах. Отдельная ошибка — это мелочь. Обычно мы просто отмахиваемся и закрываем вкладку. Но есть ли накопительный негативный эффект от таких ошибок у пользователя? Автор статьи считает, что неправильная формулировка таких сообщений плохо сказывается на восприятии сайта в целом. Поэтому маркетологам и владельцам онлайн-бизнеса обязательно нужно обращать на это внимание.

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

Подумайте о различии между этими двумя уведомлениями.

Например, после такого сообщения непонятно, что делать дальше:

«Произошла ошибка»

Второе сообщение содержит рекомендацию к действию, оно более конкретно:

«Вы не в сети. Проверьте соединение и попробуйте снова»

Так что же могут сделать разработчики?

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

Для начала спросите себя, нужно ли вам в принципе сообщение об ошибке. Подумайте, есть ли способ перепроектировать цепочку так, чтобы ошибки вообще не было.

Если вы не можете исправить основную проблему и сообщение все-таки необходимо, подумайте о тексте. Когда что-то идёт не так, и приложение «не работает», порекомендуйте что-то полезное. Оповещение должно помочь пользователю решить проблему и продолжить работу.

Советы по написанию полезных сообщений об ошибках

1. Скажите, что произошло и почему

Многие сообщения об ошибках являются неопределенными и расплывчатыми. Стоит пояснять пользователю что происходит. Расскажите о деталях простым языком. Напишите так, чтобы любой мог понять.

Представьте, что вы хотите скачать, скажем, Spotify Premium, и вы нажимаете на ссылку, чтобы начать бесплатную пробную версию. Затем вы попадаете на страницу и видите что-то вроде этого:

«Извините, у вас недостаточно прав для этого»

Неясно, почему вы не имеете права, особенно после того, как вы только что получили электронное письмо, в котором говорится: «Эй, скачайте это бесплатно». Трудно понять, в чем дело. Пользователь может просто закрыть вкладку и подумать, что это неполадки в компании или что его хотели обмануть. А это может не очень хорошо отразиться на имидже организации.

В этом случае важно сообщить пользователю, почему это произошло (например, он уже подписывался на бесплатную пробную версию раньше).

«Похоже, что вы уже приобретали пробную версию ранее, а это значит, что у вас нет доступа к этому предложению. Но вы можете оформить подписку за 9$ в месяц»

Это сообщение получилось длиннее, но в некоторых случаях лучше добавить больше информации.

2. Предложите следующий шаг

После того, как вы скажете, что произошло — сообщите пользователю, что он может сделать, чтобы решить проблему. Добавьте кнопку или ссылку. И напишите чёткий заголовок.

Представьте, что вы ищите новые подкасты. Вы запускаете приложение и видите сообщение об ошибке:

«Ошибка. Приложение устарело»

Это говорит о том, что что-то пошло не так, но это не предполагает следующего шага. Лучше сделать четкий заголовок и создать призыв к действию в виде кнопки загрузки.

«Приложение устарело. Скачайте новую версию, чтобы продолжить работу»

3. Найдите нужный тон

Задача этого уведомления — передать правильную информацию в нужное время. Но важно не только что мы говорим, но и то как мы это говорим. Когда дело доходит до тона, нужно найти правильный баланс.

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

Итак, выбирая правильный тон, начните с вопросов:

Как может пользователь почувствовать себя в этой ситуации? Если это стрессовая или серьёзная проблема, тогда шутливый тон будет неуместным.

Вы бы сказали это в повседневном диалоге? Чтение сообщения вслух поможет вам точно определить слова или фразы, которые необходимо пересмотреть.

Выводы

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

В следующий раз, когда вы будете писать сообщение об ошибке, помните об этих советах:

  • Скажите что произошло и почему
  • Предложите следующий шаг
  • Найдите правильный тон
  • И, наконец, не забудьте прочесть сообщение вслух и убрать лишние слова

Оригинал статьи: The Next Web

Предложения со словосочетанием «сообщить об ошибке»

Разъярённый клиент срочно звонит в компанию Uber, чтобы сообщить об ошибке водителя.

Звуком она «просит» поднять передачу, если вы замешкаетесь, или когда-то сообщит об ошибке, если выберете не ту передачу.

Да и до меня – а только я мог сообщить об ошибке – им было ещё далековато.

Отпущен тем же вечером в связи с тем, что дежуривший тридцать первого марта сотрудник таксопарка сообщил об ошибке в журнале прибытия – вместо 20:00 он по ошибке написал 22:00.

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

Привет! Меня зовут Лампобот, я компьютерная программа, которая помогает делать
Карту слов. Я отлично
умею считать, но пока плохо понимаю, как устроен ваш мир. Помоги мне разобраться!

Спасибо! Я стал чуточку лучше понимать мир эмоций.

Вопрос: феллах — это что-то нейтральное, положительное или отрицательное?

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

Вскоре маме сообщили об ошибке, о том, что я жива, что моё давление и общее состояние стабилизируется.

Ассоциации к слову «сообщить»

Ассоциации к слову «ошибка»

Синонимы к словосочетанию «сообщить об ошибке»

Цитаты из русской классики со словосочетанием «сообщить об ошибке»

  • Никогда не прощу себе ошибки, сделанной мною в тот вечер, когда Лопатин пришел жаловаться на свою неудачу. Я проговорился ему, сказав, что у меня есть на примете субъект, годный в натурщицы. Не понимаю, как Гельфрейх не сообщил ему об этом раньше: он знает ее так же давно, как я, если еще не дольше.
  • (все
    цитаты из русской классики)

Сочетаемость слова «ошибка»

  • большая ошибка
    роковая ошибка
    подобная ошибка
  • ошибки прошлого
    ошибка природы
    ошибки молодости
  • исправление ошибок
    множество ошибок
    цена ошибки
  • ошибка вышла
    ошибки случаются
    ошибка произошла
  • совершать ошибку
    допустить ошибку
    исправить ошибку
  • (полная таблица сочетаемости)

Значение слова «сообщить»

  • СООБЩИ́ТЬ, —щу́, —щи́шь; прич. страд. прош. сообщённый, —щён, —щена́, —щено́; сов., перех. (несов. сообщать). 1. также о чем, с придаточным дополнительным и без доп. Довести до чьего-л. сведения, уведомить, известить. Сообщить решение суда истцу. Сообщить свой адрес знакомым. (Малый академический словарь, МАС)

    Все значения слова СООБЩИТЬ

Значение слова «ошибка»

  • ОШИ́БКА, -и, род. мн.бок, дат.бкам, ж. 1. Неправильность в какой-л. работе, вычислении, написании и т. п. Допустить ошибку. Грамматическая ошибка. (Малый академический словарь, МАС)

    Все значения слова ОШИБКА

Отправить комментарий

Дополнительно

Смотрите также

СООБЩИ́ТЬ, —щу́, —щи́шь; прич. страд. прош. сообщённый, —щён, —щена́, —щено́; сов., перех. (несов. сообщать). 1. также о чем, с придаточным дополнительным и без доп. Довести до чьего-л. сведения, уведомить, известить. Сообщить решение суда истцу. Сообщить свой адрес знакомым.

Все значения слова «сообщить»

ОШИ́БКА, -и, род. мн.бок, дат.бкам, ж. 1. Неправильность в какой-л. работе, вычислении, написании и т. п. Допустить ошибку. Грамматическая ошибка.

Все значения слова «ошибка»

  • критическая ошибка
  • версия сайта
  • пакет обновления
  • запросить подтверждение
  • продолжить установку
  • (ещё синонимы…)
  • сообщник
  • донесение
  • новость
  • известие
  • (ещё ассоциации…)
  • ошибаться
  • ошибочность
  • неправильно
  • промах
  • опечатка
  • (ещё ассоциации…)
  • голос сообщил
  • источники сообщают
  • сообщить о ком-либо
  • сообщить новость
  • (полная таблица сочетаемости…)
  • большая ошибка
  • ошибки прошлого
  • исправление ошибок
  • ошибка вышла
  • совершать ошибку
  • (полная таблица сочетаемости…)
  • Разбор по составу слова «сообщить»
  • Разбор по составу слова «ошибка»
  • Как правильно пишется слово «сообщить»
  • Как правильно пишется слово «ошибка»

Правила написания сообщений об ошибках

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

Правила создания эффективных сообщений об ошибках не меняются вот уже 20 лет. Хорошее сообщение об ошибке должно:

  • Явно указывать, что что-то не так. Самое плохое сообщение об ошибке это то, которое не было создано. Если пользователи делают ошибку и не получают никакого отклика от системы, это самое худшее для них. Например, приложение работы с электронной почтой имеет несколько ситуаций, где указание о произошедшей ошибке было бы явно полезным. Скажем, вы отправили почтовое сообщение, которое было благополучно проглочено системой, но так и не достигло адресата. Еще пример? Вы сообщаете в письме, что прилагаете к нему файл, но просто забыли сделать это. Вот тут-то и нашлась бы работа для этой глупой скрепки из MS Office: «Похоже, вы хотели прикрепить файл к вашему сообщению, но не сделали этого. Хотите сделать это?».
  • Быть написано на человеческом языке, а не с использованием таинственных кодов и сокращений типа » произошла ошибка типа 2″.
  • Быть вежливым и не обвинять пользователей в том, что они такие глупые или сделали что-то не так, как например в сообщении «запрещенная команда».
  • Точно описывать источник проблемы, а не просто выдавать общие фразы типа » синтаксическая ошибка».
  • Давать конструктивный совет о том, как исправить проблему. Например, вместо того, чтобы сообщать о том, что товара » нет в наличии», ваше сообщение об ошибке должно либо сообщать, когда товар будет в наличии, или предлагать пользователям настроить отсылку им сообщения-уведомления, когда товар появится в наличии.

Самая распространенная ошибка в Web — 404 — нарушает большинство из этих правил. Я рекомендую вам написать свое собственное сообщение об ошибке 404 вместо того, чтобы полагаться на скупую серверную фразу «page not found».

Новые правила

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

  • Видимым и очень заметным, как относительно самого сообщения, так и того места, где пользователь должен исправить ошибку.

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

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

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

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

Обучение пользователей

И наконец, вы наверное уже знаетеПервый Закон Нильсена о компьютерной документации: люди ее не читают. Этот закон действует еще сильнее для веб-сайтов, где пользователи действительно избегают читать то, что не существенно для их задачи. Щелкнуть по ссылке «Помощь»? Да ни за что.

Пользователи читают документацию к системе только тогда, когда у них возникает проблема (это Второй закон). Они особенно внимательно ее читают, когда хотят исправить ошибочное действие. В этом случае вы можете использовать сообщения об ошибках в качестве обучающего материала, и подавать в них эти знания малыми порциями. Естественно, сообщения об ошибках должны быть краткими и по делу, как впрочем весь контент веб-сайта. Однако, сообщения об ошибках все-таки могут дать людям крупицы информации о том, как работает система, и подсказать, как с нею лучше работать. И в завершении этой темы, Web вводит еще одно правило:

  • Гипертекстовые ссылки можно использовать для того, чтобы связать краткое сообщение об ошибке с дополнительным материалом или объяснением проблемы. (Только, смотрите, не перестарайтесь).

1

Матил­ьда Генри­ховна
[3K]

2 года назад 

По правилам, перед гласной пишется согласная и наоборот. Об ошибке.

Об уме, об улице. Везде после об, после согласной Б идёт гласная.

Но, о предмете. О работе.

О здоровье. О любви. О сердце, о душе. Перед согласной всегда будет гласная.

система выбрала этот ответ лучшим

комментировать

в избранное

ссылка

отблагодарить

Как написать письмо об ошибке

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

Как написать письмо об ошибке

Инструкция

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

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

Вам необходимо узнать e-mail, на который вы отправите письмо. Обычно он находится в разделе «Справка» или в разделе «О программе», где написана и версия программы, которую вам необходимо указать в сообщении.

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

Чтобы сделать скриншот, при открытом окне ошибки, нажмите клавишу Print Screen, расположенную в самом верхнем ряду, справа. Затем откройте встроенный графический редактор Windows – «Пуск» – «Все программы» – «Стандартные» – Paint.net. В верхнем меню нажмите «Правка», затем «Вставить». Или сочетание клавиш Ctrl+V. Затем нажмите меню «Файл» — «Сохранить как», сохраните файл на рабочий стол.

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

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

Войти на сайт

или

Забыли пароль?
Еще не зарегистрированы?

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

Понравилась статья? Поделить с друзьями:
  • К какому виду опасностей относятся ошибки персонала
  • Итоговое сочинение цена ошибки
  • К какой ошибке ведет незнание значения слова
  • Итоговое сочинение на тему опыт и ошибки
  • К источникам права древнего египта относятся найдите ошибку