Usa anotações Swagger para documentar controladores?

Sim, as anotações Swagger são amplamente utilizadas para documentar controladores REST em aplicações Java. Elas permitem descrever a API, seus métodos, parâmetros, respostas e outras informações meta diretamente no código, facilitando a geração de documentação interativa (por exemplo, Swagger UI).

Exemplo de uso com Spring Boot e Swagger (OpenAPI):

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

    @Operation(summary = "Obter usuário por ID")
    @GetMapping("/{id}")
    public User getUserById(@Parameter(description = "ID do usuário") @PathVariable Long id) {
        // lógica para obter o usuário
    }
}

Este método simplifica a manutenção e compreensão da API, além de ajudar os desenvolvedores frontend e outros consumidores do serviço a navegar rapidamente pelos endpoints disponíveis.