Content
@
https://opensea.io/collection/dev-21
0 reply
0 recast
2 reactions
@git
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
3 replies
0 recast
10 reactions
atlasmoth
@osuji.eth
Why's it the wrong direction to use tools tho? Just curious
1 reply
0 recast
0 reaction
@git
because generating spec from code ends up being incomplete and tools ignore a bunch of openapi fields. If you read carefully a good openapi spec you’ll understand
0 reply
0 recast
0 reaction
