A place for developers to talk about building on Farcaster.

/dev

Best tools for generating REST API documentation?

NOTHING beats hand crafting your OpenAPI spec

Often devs go about this the wrong direction: looking for tools that generate OpenAPI/Swagger spec and docs from some code

Instead, start with hand crafting your OpenAPI spec and then use it to generate a client/sdk (ts/go/py/any language) and docs

stainlessapi.com

I generally like to have a starting point with a postman collection and then fill in the rest by hand, and that part really is my favorite. Very satisfying

https://github.com/o-az
—
https://x.com/awkroot

Full Stack Dev | Head of Developer Relations at /pinata | Technical Writer | Tinkering with everything | stevedylan.dev/links

postman is bloated software. I like hopposcotch