Do you use Swagger annotations for documenting controllers?

Yes, Swagger annotations are widely used for documenting REST controllers in Java applications. They allow describing the API, its methods, parameters, responses, and other metadata directly in the code, which facilitates the generation of interactive documentation (e.g., Swagger UI).

Example of usage with Spring Boot and Swagger (OpenAPI):

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

    @Operation(summary = "Get user by ID")
    @GetMapping("/{id}")
    public User getUserById(@Parameter(description = "User ID") @PathVariable Long id) {
        // logic to get user
    }
}

This approach simplifies API maintenance and understanding, and also helps frontend developers and other service consumers quickly navigate available endpoints.