A place for developers to talk about building on Farcaster.

/dev

Best tools for generating REST API documentation?

Do you mean generating like an open API spec from source code or generating user-friendly reference docs (like this https://docs.bsky.app/docs/api/app-bsky-actor-get-profiles ) from the API spec?

If you have an OpenAPI spec the options are endless, both self hosted and paid. If you don’t have a spec you can make one pretty quickly using a Postman collection and this tool to convert it https://github.com/joolfe/postman-to-openapi

There’s also tools you can include with the build of the API that will automatically generate it. 

If you don’t want to do an OpenAPI spec the next best option might be Gitbook but would be manual work, at which point it would be easier to just build the spec.

Swagger? Its pretty good. Using it at my current company.