Документация API должна жить рядом с кодом

Если документация обновляется отдельно от кода, она почти неизбежно начинает врать.

Для backend-проекта лучше держать OpenAPI-схему частью обычного development workflow.