News for hackers. Stuff that matters.

A comment on Scalar: An open-source alternative to Redocly and Swagger UI. Parent comment

Re:Scalar: An open-source alternative to Redocly and Swagger UI by simonw on Friday October 13, 2023 @01:15PM (#37872981)
That's what I meant by "interactive features using JavaScript layered over the top" - you can still have the embedded REST API client behaving exactly the same, but if you load the page without JavaScript (e.g. a search engine crawler) you get the rest of the content as HTML.

Great point about feeding the Swagger files straight into the LLM.

[ Parent | on HN ]
Re:Scalar: An open-source alternative to Redocly and Swagger UI by ushakov on Friday October 13, 2023 @01:33PM (#37873216)
> Great point about feeding the Swagger files straight into the LLM.

That doesn't scale though. Notion OpenAPI doc is more than 6k lines. You will have to resort to some splitting techniques or using vector stores

[ Parent | on HN ]
Re:Scalar: An open-source alternative to Redocly and Swagger UI by simonw on Friday October 13, 2023 @05:26PM (#37875820)
... or you can use Claude with it's 100,000 token limit. I've had some very impressive results from Claude against long documents.
[ Parent | on HN ]