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