OpenAPI(swagger): Генерация рускоязычного описание API

Заказчик у нас - московское метро, из этого возникают странные задачи типа необходимости иметь фиксированное, а не живое описание API, причем на русском языке.

Уже первая задача непростая, ведь гораздо удобнее для изучения Open API использовать swagger ui, который, например, входит в генерируемые с помощью swagger codegen сервера.

Но заказчику надо что-то, что он может положить в шкаф. То, что выходит из swagger codegen таковым не является.

Ок, нашелся bootprint-openapi.

Вторая проблема, с русификацией, решалась несложно - я форкнул проект и буквально за полчаса получил устраивающую нас русификацию (она не совсем точна с точки зрения OpenAPI, но она отражает именно то, что мы хотели показать заказчику).

Правда, как обычно, двумя проблемами никогда не заканчивается, потом возникла третья, но это уже другая история.