News for hackers. Stuff that matters.

A comment on GraphQL Is a Trap?. Parent comment

Re:GraphQL Is a Trap? by TameAntelope on Friday May 06, 2022 @04:25PM (#31289291)
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

[ Parent | on HN ]
Re:GraphQL Is a Trap? by dimgl on Friday May 06, 2022 @10:40PM (#31291718)
I 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
[ Parent | on HN ]
Re:GraphQL Is a Trap? by dylanowen on Saturday May 07, 2022 @03:20PM (#31297659)
You can read your open api spec or wsdl without a tool but why would you? It's the same for the graphql schema.
[ Parent | on HN ]
Re:GraphQL Is a Trap? by TameAntelope on Friday May 06, 2022 @11:02PM (#31291810)
You can't use a nail without a hammer.
[ Parent | on HN ]
Re:GraphQL Is a Trap? by larrik on Monday May 09, 2022 @02:22PM (#31317849)
Well, it's completely true that I hadn't heard of Insomnia. I wish I had.
[ Parent | on HN ]