Чем OpenAPI/Swagger отличается от manual docs и когда что выбрать?
Что хотят услышать интервьюеры:
Сравнение: OpenAPI/Swagger стоит сравнивать с manual docs по критериям читаемости, безопасности, производительности, тестируемости и поддержки командой.
Ответ:
Когда выбирать OpenAPI/Swagger: когда его свойства прямо соответствуют задаче: OpenAPI документирует контракт API и помогает frontend/backend integration.
Слабый ответ: “так принято в Spring/Java”. На собеседовании лучше объяснить ограничения и цену выбора.
// springdoc-openapi генерирует спецификацию