swagger-markdown
redocly-cli
swagger-markdown | redocly-cli | |
---|---|---|
1 | 2 | |
227 | 819 | |
- | 3.8% | |
5.1 | 9.3 | |
about 1 month ago | about 8 hours ago | |
TypeScript | TypeScript | |
MIT License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
swagger-markdown
-
Generating docs from OpenAPI Spec
The first iteration involved adding a small build script to the docs repo that cloned the backend repo and used swagger-markdown on each file to generate markdown. Docusaurus found the markdown files and did the rest.
redocly-cli
- Show HN: Redocly CLI stable release 1.0
-
Generating docs from OpenAPI Spec
In order to use Redocusaurus, I needed a single spec file. Both Swagger cli and OpenApi cli offered an option to merge separate specs into one. The problem was that one of them required a "root spec file" to drive the merging and the other required extra information to resolve conflicts. My specs had neither.
What are some alternatives?
swagger-cli - Swagger 2.0 and OpenAPI 3.0 command-line tool
redoc - 📘 OpenAPI/Swagger-generated API Reference Documentation
openapi - An OpenAPI specification for the Stripe API.
next-swagger-doc - This package reads your JSDoc-annotated source code on NextJS API route and generates an OpenAPI (Swagger) specification.
Docusaurus - Easy to maintain open source documentation websites.
gifski-command - Node.js module for gifski GIF encoder CLI
widdershins - OpenAPI / Swagger, AsyncAPI & Semoasa definitions to (re)Slate compatible markdown
openapi-starter - OpenAPI starter repository
spectral - A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI v3.1, v3.0, and v2.0 as well as AsyncAPI v2.x.