News for hackers. Stuff that matters.

A comment on Show HN: A faster way to prototype your APIs using OpenAPI 3 and Swagger UI. Parent comment

Re:Show HN: A faster way to prototype your APIs using OpenAP... by ccleve on Friday October 23, 2020 @02:12PM (#24872213)
How do you use it for generating documentation? Can you generate anything other than Swagger UI for API docs?
[ Parent | on HN ]
Re:Show HN: A faster way to prototype your APIs using OpenAP... by smt88 on Saturday October 24, 2020 @07:52PM (#24882821)
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

[ Parent | on HN ]