4 ms·
Every single time I've heard "GraphQL is poorly documented", it's from someone who doesn't know about Insomnia [0] (or something like it) and autocompletion. Y
by TameAntelope 4y ago
Every single time I've heard "GraphQL is poorly documented", it's from someone who doesn't know about Insomnia [0] (or something like it) and autocompletion.
You can traverse the docs as you write the code with the right client app, and this solves 90% of the "docs are bad" complaints about any given GraphQL API.
GraphQL APIs are many things. Poorly documented is not one of them.
[0] https://insomnia.rest/products/insomnia https://insomnia.rest/products/insomnia
- dimgl 4y agoI gotta say, if you need another tool to make your tool somewhat usable, that tool probably isn't very good in the first place? Lol
- TameAntelope 4y agoYou can't use a nail without a hammer.
- dylanowen 4y agoYou can read your open api spec or wsdl without a tool but why would you? It's the same for the graphql schema.
- larrik 4y agoWell, it's completely true that I hadn't heard of Insomnia. I wish I had.