← Все статьи

Исправление, которое можно доказать: от воспроизведения к проверке

О коллекции

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

Исправление полезно уметь показать: вот действие, вот прежний сбой, вот ожидаемое поведение после правки. Без этой цепочки можно долго спорить о впечатлениях.

Содержание 8

Зафиксируйте минимальный сценарий проблемы

Опишите исходное состояние, действия и наблюдаемый результат. Уберите лишние шаги, пока ошибка остается воспроизводимой. Сохраните только необходимые технические сведения, не копируя чужие личные данные или секреты. Для интерфейсного сбоя полезна последовательность действий, для доступа — роли и идентификаторы учебных объектов, для расчета — входные значения. Ожидаемое поведение нужно записать до изменения кода. Иначе легко подогнать объяснение под получившийся результат.

На практике

Исправляйте границу ответственности

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

На практике

Оставьте наблюдаемость и границы

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

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

На практике

Перед тем как передать материал дальше

  • ☐Записать минимальное воспроизведение и ожидаемый результат.
  • ☐Исправить правило на правильной стороне системы.
  • ☐Повторить проблемный и нормальный сценарии.
  • ☐Добавить безопасную диагностику и назвать оставшиеся ограничения.

Работы из этого разбора

Источники

Обсуждение

Задайте вопрос об этой работе, обсудите решение или поделитесь своим опытом.

Обсуждение открыто для всех участников.

Загружаем комментарии…