У меня просто ощущение, что выдать команде доку будет менее затратно по ресурсам
Это не дока. Это реализация сильной типизации в проекте. Ограничения, при которых закоммитить в репу конфиг с кривым запросом будет технически невозможно.
Написанная однажды схема избавит от необходимости колдовать над каждым запросом — в редакторе сразу заимплементится автокомплит, и все ошибки он подчеркнёт ещё при написании кода. Нереально ошибиться.