[{"data":1,"prerenderedAt":200},["ShallowReactive",2],{"project-26507373":3},{"id":4,"name":5,"line":6,"line_source":7,"title":8,"url":9,"domain":10,"maker":11,"posted_at":12,"year":13,"points":14,"comments":15,"rank_in_year":16,"shown_in_year":17,"top":18,"tier":19,"category":20,"subcategory":21,"format":22,"keywords":23,"reception":27,"sentiment":28,"stance_mix":29,"scored_comments":33,"aspects":34,"strip":39,"post_text":28,"what":42,"said":72,"maker_in_thread":132,"shape":139,"grid":142,"attempts":163,"same_week":164,"maker_shows":40,"maker_hidden":193,"reader_version":194,"card":195},"26507373","SpectaQL","auto-generate GraphQL API documentation","title","Show HN: SpectaQL – auto-generate GraphQL API documentation","https:\u002F\u002Fgithub.com\u002Fanvilco\u002Fspectaql#spectaql","github.com","mrbogle",1616100464,2021,51,13,844,2533,34,"notable","dev_tools","documentation generator","cli",[24,25,26,21],"graphql","api documentation","schema docs","quiet",null,{"positive":30,"neutral":31,"mixed":31,"critical":32},2,1,0,4,{"performance":35,"design":36,"idea":37,"pricing":38},{"positive":31,"critical":32},{"positive":32,"critical":32},{"positive":32,"critical":32},{"positive":31,"critical":32},[40,32,32,41,32,41,32,32,40,32],5,3,{"problem":43,"audience":51,"pricing":59,"motivation":63,"time_to_build":28,"stack":68,"openness":69,"stage":70,"team_size":71},{"value":44,"source":45,"evidence":46},"Documenting large GraphQL APIs by hand or with existing generators that don't scale","commenter",[47],{"id":48,"by":49,"text":50},"26507902","hirundo","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…",{"value":52,"source":53,"evidence":54},"Developers maintaining GraphQL APIs","inferred",[55,58],{"id":56,"by":11,"text":57},"26507552","Hey all, we couldn't find exactly what we wanted in a documentation generator, so we wrote our own. Let us know if you have any questions!",{"id":48,"by":49,"text":50},{"value":60,"source":45,"evidence":61},"Open license",[62],{"id":48,"by":49,"text":50},{"value":64,"source":65,"evidence":66},"Couldn't find a documentation generator that met their needs, so they wrote their own","maker",[67],{"id":56,"by":11,"text":57},[],"open_source","launched","company",{"praise":73,"objections":92,"requests":100,"questions":115,"alternatives":116},[74,78,85],{"value":75,"source":45,"evidence":76},"Integrated examples are useful",[77],{"id":48,"by":49,"text":50},{"value":79,"source":45,"evidence":80},"Saves money versus paid documentation generators",[81],{"id":82,"by":83,"text":84},"26509759","linkdd","Amazing, our free trial of GraphQL Editor that we used only for its documentation generator ended, so this is literal a time\u002Fmoney saver. Thank you! EDIT: Have you thought about…",{"value":86,"source":45,"evidence":87},"Works well in automated pipelines",[88],{"id":89,"by":90,"text":91},"26513921","okaramian","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…",[93],{"value":94,"source":45,"evidence":95},"Single-page layout does not scale to 100+ types and 800+ mutations; sidebar becomes unwieldy",[96,97],{"id":48,"by":49,"text":50},{"id":98,"by":11,"text":99},"26508050","Thanks 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.…",[101,107,111],{"value":102,"source":45,"evidence":103},"Dynamic interactive schema diagram for navigating types",[104],{"id":105,"by":49,"text":106},"26508093","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…",{"value":108,"source":45,"evidence":109},"Accept GitHub sponsorships",[110],{"id":82,"by":83,"text":84},{"value":112,"source":45,"evidence":113},"Searchable hosted white-label version",[114],{"id":48,"by":49,"text":50},[],[117,121,125],{"value":118,"source":45,"evidence":119},"GraphQL Editor",[120],{"id":82,"by":83,"text":84},{"value":122,"source":45,"evidence":123},"DociQL",[124],{"id":89,"by":90,"text":91},{"value":126,"source":45,"evidence":127},"Shopify's sectioned API docs approach",[128],{"id":129,"by":130,"text":131},"26508746","bretthopper","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:…",{"comments":40,"answered":31,"key":133},[134,137,138],{"id":135,"text":136},"26515294","We added a number of things that came to mind while trying to get our docs dialed in ourselves. Glad to see that others were looking for these same enhancements! Let us know if…",{"id":56,"text":57},{"id":98,"text":99},{"commenters":40,"max_depth":40,"maker_replies":40,"first_comment_mins":140,"lifespan_hours":141},19,20,[143,145,147,149,151,152,153,156,158,160],[89,32,40,144,90,32],"project\u002Fpositive\u002Fperformance",[135,32,32,146,11,31],"maker\u002Fneutral\u002Fnone",[56,31,32,148,11,31],"project\u002Fneutral\u002Fidea",[48,31,41,150,49,32],"project\u002Fmixed\u002Fdesign",[98,31,32,146,11,31],[105,31,41,148,49,32],[154,31,32,155,11,31],"26508191","maker\u002Fneutral\u002Fidea",[129,31,32,157,130,32],"other\u002Fneutral\u002Fdesign",[82,30,40,159,83,32],"project\u002Fpositive\u002Fpricing",[161,30,32,162,11,31],"26515440","maker\u002Fneutral\u002Fpricing",[],[165,170,174,179,183,188],{"id":166,"name":167,"points":168,"category":169},"26568014","Practical Go Lessons",919,"languages",{"id":171,"name":172,"points":173,"category":20},"26503572","Sorted CSS Colors",559,{"id":175,"name":176,"points":177,"category":178},"26537734","compiler.org",219,"learning_science",{"id":180,"name":181,"points":182,"category":20},"26554451","PyWebIO",200,{"id":184,"name":185,"points":186,"category":187},"26503715","LitiHolo",180,"hardware",{"id":189,"name":190,"points":191,"category":192},"26573930","Arc",175,"data",false,"v2",{"id":196,"name":5,"line":6,"ai":193,"cat":20,"year":13,"points":14,"comments":15,"rec":27,"s":28,"top":18,"kw":197,"maker":11,"domain":10,"tier":19,"attempts":32,"strip":198,"url":9,"mix":199,"praise":75,"objection":94,"sub":21},26507373,[24,25,26,21],"5003030050",[30,31,31,32],1794036604656]