Gebruik je Swagger-annotaties voor het documenteren van controllers?

Да, Swagger-аннотации широко используются для документирования REST-контроллеров в Java-приложениях. Они позволяют описать API, его методы, параметры, ответы и другую метаинформацию прямо в коде, что облегчает генерацию интерактивной документации (например, Swagger UI).

Пример использования с Spring Boot и Swagger (OpenAPI):

@RestController
@RequestMapping("/api/users")
public class UserController {

    @Operation(summary = "Получить пользователя по ID")
    @GetMapping("/{id}")
    public User getUserById(@Parameter(description = "ID пользователя") @PathVariable Long id) {
        // логика получения пользователя
    }
}

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