SpectaQL
Dev tools
documentation generator
SHOW HN2021
How HN took it
2 positive, 1 neutral or asking, 1 mixed, 0 critical, out of 4 comments about the project.
Performance: 1 for, 0 againstPricing: 1 for, 0 against
The thread, comment by comment
Each row is a top-level comment and its replies, in HN's order. Select a cell to open that comment on HN.
positive neutral or mixed critical about another commenter or something else the maker
What HN said
What people liked
Integrated examples are useful
From 1 comment
I appreciate the integrated examples. I wish I had your example generator before I rolled my own. The documention generator we currently use isn't scaling well with 100+ types…
hirundo on HN
Saves money versus paid documentation generators
From 1 comment
Amazing, our free trial of GraphQL Editor that we used only for its documentation generator ended, so this is literal a time/money saver. Thank you! EDIT: Have you thought about…
linkdd on HN
Works well in automated pipelines
From 1 comment
I've been using DociQL in an automated pipeline and its been handy! Should be easy to give this a go at some point in the near future. I made a similar change for the…
okaramian on HN
Objections
Single-page layout does not scale to 100+ types and 800+ mutations; sidebar becomes unwieldy
From 2 comments
I appreciate the integrated examples. I wish I had your example generator before I rolled my own. The documention generator we currently use isn't scaling well with 100+ types…
hirundo on HNThanks for the feedback! Yeah I can see how it could get out of hand with that many types and mutations. The single page situation would probably break down in that scenario too.…
mrbogle on HN
Requests
Dynamic interactive schema diagram for navigating types
From 1 comment
What I'd really like to see is a dynamic diagram of the schema, such that when you click on a type it becomes the center of a graph of associations. Then click to view the text…
hirundo on HN
Accept GitHub sponsorships
From 1 comment
Amazing, our free trial of GraphQL Editor that we used only for its documentation generator ended, so this is literal a time/money saver. Thank you! EDIT: Have you thought about…
linkdd on HN
Searchable hosted white-label version
From 1 comment
I appreciate the integrated examples. I wish I had your example generator before I rolled my own. The documention generator we currently use isn't scaling well with 100+ types…
hirundo on HN
Alternatives named
GraphQL Editor
From 1 comment
Amazing, our free trial of GraphQL Editor that we used only for its documentation generator ended, so this is literal a time/money saver. Thank you! EDIT: Have you thought about…
linkdd on HN
DociQL
From 1 comment
I've been using DociQL in an automated pipeline and its been handy! Should be easy to give this a go at some point in the near future. I made a similar change for the…
okaramian on HN
Shopify's sectioned API docs approach
From 1 comment
We quickly ran into the same issue at Shopify. We've since moved from a flat list into sections by "domains"; within each section is the breakdown by type. You can see it here:…
bretthopper on HN