Scalar: Generate interactive API documentations from Swagger files

Post by paulddraper » Fri, Oct 13, 2023, 8:24 PM UTC

treve wrote: post #59

Isn't swagger deprecated for like a decade? It looks like it supports OpenAPI, but interesting to focus on Swagger

Post by simonw » Fri, Oct 13, 2023, 9:26 PM UTC

ushakov wrote: post #23

simonw wrote: post #14

Earlier quoted context omitted.

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.

> 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

Post by treve » Fri, Oct 13, 2023, 9:36 PM UTC

marclave wrote: post #62

treve wrote: post #59

Isn't swagger deprecated for like a decade? It looks like it supports OpenAPI, but interesting to focus on Swagger

We support Swagger + OAS 3/3.1 The language can be better throughout the repo so we will update that :) appreciate the comment

Post by GordonS » Fri, Oct 13, 2023, 9:55 PM UTC

maxloh wrote: post #4

Aren't Redocly and Swagger UI open-source too?

Post by jamietanna » Sat, Oct 14, 2023, 8:51 PM UTC

marclave wrote: post #49

melolife wrote: post #25

Earlier quoted context omitted.

After some more experimentation it looks like you don't support allOf/anyOf/oneOf which seems like a pretty big hole.

our swagger parser isnt perfect yet, appreciate this comment and I added it to triage. We will get this fixed quick