Не совсем согласен с вашим утверждением, что доку по api должен писать фронтэнд разработчик, мое мнение такое, это зависит от того, какое у вас api: публичное или нет, то есть использовать его будет только ваше веб приложение или пользователем api может быть и обычный пользователь...в первом случае возможно пусть фронт как то рулит апи, там уж ваше дело, но вот во втором случае должен делать тот кто делает эту api)
Написано
Войдите на сайт
Чтобы задать вопрос и получить на него квалифицированный ответ.