Раздосадованный коллега
14.01.2024 #How

Как писать жалобы в ТП?

1. Обращение должно быть понятным

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

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

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

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

Идеальный алгоритм выглядит как-то так:

  1. Воспроизведи ошибку. Воспроизвелась? Отлично. Не воспроизвелась? Значит, что-то не учтено. Вспоминай. В большинстве случаев уже это помогает написать подробное описание.
  2. Если, это требуется, опиши проблему более подробно — уточни детали. Если понимаешь, в чем причина проблемы (используется устаревшая формула для расчетов, не учитывается какое-то значение и т.д.) — тоже пиши.
  3. Если проблема с визуальным отображением, то приложи скриншот или видео. Так можно будет понять ошибку и без воспроизведения шагов.

Что: неправильный расчет данных
Где: на странице https://…. или на iphone 12
Когда: после ввода в поле Y отрицательного значения.

— Идеальный шаблон, запомни его и всегда старайся придерживаться

2. Упрости себе жизнь

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

Если проблема с визуальным отображением, то скриншот обязателен, только так можно будет понять ошибку.
Сделать скриншот, очень просто:

  • Windows или Linux: Alt + Print Screen
  • Mac: Command + Shift + 3
  • Android: Кнопка уменьшение громкости + Кнопка включения
  • iPhone: Кнопка домой + Пробуждение

затем в окне любого мессенджера Ctrl + v

Для того чтобы пояснить проблему прямо на скриншоте, поставьте какую-либо программу:

  • Snip & Sketch – только Windows 10 Windows key + Shift + S
  • ShareX – под все платформы
  • Snipaste – только Windows 10
  • Nimbus Capture – только Chrome
  • Joxi – проект не развивается 🙁
  • Yandex Disk – пакетом идёт Яндекс.Спам

Они сильно упростят вам всем вокруг вас жизнь.

Если это многошаговый баг, можно воспользоваться программой для записи видео:

3. Не упрекайте и не обвиняйте.

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

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

4. Доведите дело до конца

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

Если сообщение не адресовано кому-то конкретно, то оно адресовано никому. Коллективная ответственность только в СССР идеалистическом будущем.