Объясни технический термин человеку без инженерного бэкграунда, который ведёт продукт и завтра принимает по этому термину решение.
Термин: [ТЕРМИН: идемпотентность запросов]
Кто спрашивает: [КТО: продакт платёжного сервиса, в код не заходит, отвечает за сроки релиза]
Почему всплыл: [КОНТЕКСТ: при повторной отправке платежа клиенту иногда списывается вторая сумма, разработчик просит спринт на «идемпотентные ключи»]
Четыре блока подряд, каждый под своим номером, без списков внутри блока. Первый — аналогия из бытовой жизни, до шестидесяти слов, ни одного технического слова, и последней строкой честно: в каком месте аналогия перестаёт работать. Второй — что происходит на самом деле, до ста слов. Третий — чем это оборачивается для продукта: деньги, сроки, репутация, с конкретной ситуацией из контекста выше и с ценой отсрочки на квартал. Четвёртый — один вопрос разработчику, сформулированный так, что ответом будет число или дата.
Отсечка. Не подменяй объяснение определением из документации и не пиши «на самом деле всё просто» — если понадобилось это сказать, объяснение не получилось. Не решай за продакта, брать задачу в спринт или нет: твоё дело — основания, решение его. Аналогию не тяни на весь ответ: она вводит мысль, а не заменяет её.
Проверка. Перечитай готовый текст и вычеркни каждое слово, которое продакт не смог бы завтра повторить коллеге по памяти; если абзац после этого рассыпался, перепиши его целиком другими словами. Затем посмотри на вопрос из четвёртого блока: если на него можно ответить «да» или «нет», переделай — он должен требовать цифру или дату.