Инструкции пользователей при изменении UI
Директивный
Правило
Заголовок раздела «Правило»Если изменение заметно пользователю — новые поля и кнопки, перенесённые команды, изменившийся порядок действий, новые обязательные реквизиты — вместе с релизом выходит и документация:
- Есть инструкция — она обновлена в той же задаче (скриншоты в том числе: инструкция со старым интерфейсом хуже, чем её отсутствие, — ей верят).
- Инструкции нет — выходит памятка «что изменилось»: 3–5 предложений и скриншот, отправленные пользователям/заказчику до или вместе с релизом, а не после первой волны обращений.
- В памятке — не «что мы сделали», а что делать пользователю: где теперь кнопка, что заполнять в новом поле, что будет, если оставить пустым.
- Кто отправляет и по какому каналу — фиксируется в задаче (автор доработки, аналитик, поддержка), но отправка — часть definition of done задачи.
Для команды перенос кнопки — косметика; для кассира в смену — «всё сломалось». Каждое молчаливое изменение UI конвертируется в волну обращений в поддержку, простои на местах и недоверие к обновлениям («опять что-то выкатили»). Стоимость памятки — 15 минут; стоимость её отсутствия — день поддержки на объяснение одного и того же ста пользователям по одному.
Когда не применять
Заголовок раздела «Когда не применять»- Изменение не видно пользователю (рефакторинг, оптимизация, серверная логика при том же сценарии) — не требуется.
- Интерфейс для самой ИТ-команды (служебные обработки, консоли) — достаточно описания в задаче/карточке обработки.