What does HackerNews think of redoc?

šŸ“˜ OpenAPI/Swagger-generated API Reference Documentation

Language: TypeScript

#159 in Hacktoberfest
#11 in React
Show HN: Iā€™m building open-source headless CMS for technical content | Jun 2023
Expand Context ā†•
There are a few other tools out there that are at least marginally better than the default Swagger UI such as ReDoc (https://github.com/Redocly/redoc).

When we redid the Mux docs (https://docs.mux.com/api-reference) we actually just decided to build our own renderer. It really wasn't as bad as you might think, at build time we pull in the JSON version of our OAS spec and render it as a static build in our Nextjs app. Don't get me wrong, it wasn't trivial, but the benefit of having complete control over the output has been well worth it.
Building API Docs | Feb 2022
Expand Context ā†•
Did you try https://github.com/Redocly/redoc ?
Show HN: A faster way to prototype your APIs using OpenAPI 3 and Swagger UI | Oct 2020
Expand Context ā†•
The best CLI documentation generator I've found so far is Redoc[1].

There are tons of hosted solutions for docs (Apimatic, SwaggerHub, Stoplight, and Apicurio Studio).

My favorites are SwaggerHub[2] and Apicurio[3], because their editors are solid and they have good compatibility with all the nooks and crannies of the OpenAPI v3 spec.

1. https://github.com/Redocly/redoc

2. https://swagger.io/tools/swaggerhub

3. https://studio.apicur.io
Slate, create beautiful, responsive API documentation | Aug 2020
I've seen Slate. I know CircleCI uses them. Personally however I am a huge fan of redoc. Something about the way redoc looks and the way it is served makes me want to pick them over slate.

https://github.com/Redocly/redoc

I've managed to get both the companies I work at use redoc instead of slate :)