Как сообщить об ошибке разработчикам

В технических проектах все должно измениться. Независимо от того, хотите ли вы, чтобы новые функциональные возможности, операционные системы продолжались или что-то ломалось (подробнее об этом позже), время от времени должны происходить изменения. Со временем программное обеспечение нуждается в обновлении и изменении, и этого не избежать.

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

Что за ошибка?

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

Некоторые распространенные примеры ошибок:

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

Почему происходят ошибки и кто за это отвечает?

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

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

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

Когда ошибка не ошибка?

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

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

Некоторые распространенные примеры проблем, которые не являются ошибками:

  • Любая проблема, вызванная программным обеспечением или приложением, не написанным разработчиком, поставляющим программное обеспечение (например, у вас есть интеграция с Twitter и Twitter отключается)
  • Желаемый элемент был упомянут в прохождении / начальных обсуждениях, но не был включен в ваши краткие или макеты, которые затем были подписаны
  • Кто-то в вашей команде решает, что им не нравится внешний вид текущей формы, даже если она по сути такая же, как показано в спецификации, и хочет, чтобы кнопки были внизу формы, а не вверху (повторное ознакомление)

Как сообщить об ошибке?

Что-то не работает правильно. Чем ты занимаешься?

Шаг 1: это ошибка?

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

  • Попробуйте в разных браузерах. Например, если вы используете Chrome, проверьте сайт в Firefox.
  • Убедитесь, что ваш браузер обновлен. Если у вас нет последних обновлений, у браузера могут быть проблемы.
  • Проблема связана с тем, что вы вошли в систему или вышли из системы?
  • Если товарищ по команде сообщает вам об ошибке, проверьте ее, чтобы убедиться, что она не испытывает ни одной из вышеуказанных проблем.
  • Сверьтесь с планом / заданием вашего проекта и убедитесь, что проблема определенно является тем, что должен делать сайт

Шаг 2: Документируйте ошибку и сообщите о ней

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

Вот простой набор вопросов для ответа и включения в ваш отчет:

  • По какому URL-адресу страницы у вас возникли проблемы?
  • Что это должно сделать?
  • Что на самом деле делает, в чем проблема?
  • Какой браузер и какое устройство вы используете? Идеальный отчет может выглядеть так: «Я использую Chrome версии 67.0.3396.99 на iPhone X 11.4.1»
  • Что вы видите? Чем визуальнее, тем лучше. Снимки экрана или короткие видео идеальны, и вы можете использовать Awesome Screenshot или Kap, чтобы легко собрать их.
  • Насколько актуальна проблема? Когда и почему вам нужно решить эту проблему? Если вы теряете тысячи пожертвований из-за того, что обработка вашей карты не работает, это было бы срочным решением, но если есть проблема с изображением на старой странице, на котором нет трафика, это, конечно, менее срочно.

Шаг 3: Подтвердите следующие шаги

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

Особая благодарность фантастической команде Louder Than Ten, которая подготовила множество великолепных ресурсов для управления проектами, некоторые из которых сообщили об этом.

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

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

И, конечно, если вам понравилась эта статья, пожалуйста, добавьте апплет ниже и поделитесь этой частью - это означает мир для нас в DEV.