Короткий ответ
Нельзя додумывать детали самостоятельно: нужно уточнить требования у автора задачи (аналитика, продакт-менеджера) и зафиксировать договорённость письменно, прежде чем приступать к реализации.
Как это работает подробнее
Неполное требование — это сигнал, что решение ещё не принято, а не повод импровизировать. Разработчик формулирует конкретные вопросы (какие поля, какой формат файла, что с пустыми значениями, нужна ли пагинация для больших отчётов) и получает ответы до написания кода.
Пример кода
example.txt
Плохо:
Разработчик молча решает, что экспортировать все 40 полей таблицы и выгружать .xlsx
— через неделю выясняется, что нужен .csv с 6 полями для загрузки в другую систему.
Хорошо:
Комментарий в тикете: "Уточните, пожалуйста: 1) какие поля нужны в отчёте,
2) формат файла (csv/xlsx), 3) есть ли лимит на число строк?"
Ответ зафиксирован в тикете — можно приступать к реализации.Что использовать на практике
- Практика. Вопросы лучше задавать сразу все и в письменном виде (тикет, чат), чтобы ответ стал частью истории задачи и к нему можно было вернуться. Если автор задачи недоступен, стоит предложить разумное умолчание и явно описать его в комментарии к задаче, чтобы его можно было поправить до ревью. Полезно также прикладывать к уточняющему вопросу конкретный пример («если поле «скидка» пустое — показывать 0 или прочерк?»), потому что на абстрактный вопрос без примера легко получить такой же абстрактный и бесполезный ответ.
Подводные камни
- Риски. Типичная ошибка — начать кодить «как кажется логичным» и переделывать после того, как фича не понравится на демо: это тратит больше времени, чем пять минут уточнения. Другая ошибка — закидать автора задачи сразу десятком мелких вопросов по одному, вместо того чтобы собрать их в один список. Также встречается ситуация, когда разработчик получает ответ только на часть вопросов и тихо додумывает остальное сам, вместо того чтобы дожать уточнение до конца.