Have you used Swagger for API documentation?

Yes, Swagger is a popular tool for documenting RESTful APIs. It allows describing the API structure in the OpenAPI Specification format, which makes it easier to understand and test services.

With Swagger, you can automatically generate interactive documentation where developers and testers can see available endpoints, request parameters, response types, and examples. Swagger also supports generating client code and server stubs.

An example of using Swagger in a Java project with Spring Boot:

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

    /**
     * Get list of users
     * @return list of users
     */
    @GetMapping
    public List<User> getUsers() {
        // logic to get users
    }
}

Swagger annotations (e.g., @ApiOperation) can be added for more detailed descriptions, and then generate documentation via Swagger UI.