redocly-cli
openapi
redocly-cli | openapi | |
---|---|---|
2 | 2 | |
815 | 359 | |
3.3% | 1.4% | |
9.3 | 9.8 | |
5 days ago | 4 days ago | |
TypeScript | Ruby | |
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.
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.
openapi
-
The Collison Brothers Built Stripe into a $95B Unicorn
I wonder if there is a format for API -> client automation that can be good enough, in the end Stripe have a rest API, with enough description it should be possible.
Okay so after a quick google it appears Microsoft are the "Simpsons already done it" of the programming world: https://github.com/Azure/autorest/
It'd probably be a good idea to add an Elixir backend for that and point it at Stripe's API here: https://github.com/stripe/openapi
-
Generating docs from OpenAPI Spec
Our specs were split between several YAML spec files. It looked like a good idea when we did that - large files are not fun to work with. The problem is that very little in the OpenAPI ecosystem was built for multiple files. I strongly recommend that you will save yourself the pain and go the mono-file route. If Stripe can have a 4.5MB spec file, so can we.
What are some alternatives?
redoc - 📘 OpenAPI/Swagger-generated API Reference Documentation
cardano-python - Python module for handling Cardano cryptocurrency
next-swagger-doc - This package reads your JSDoc-annotated source code on NextJS API route and generates an OpenAPI (Swagger) specification.
plutus-starter - A starter project for Plutus apps
swagger-cli - Swagger 2.0 and OpenAPI 3.0 command-line tool
Docusaurus - Easy to maintain open source documentation websites.
openapi-starter - OpenAPI starter repository
swagger-markdown - swagger to markdown transpiler
docs-cardano-org - Documentation for Cardano