openapi
redocly-cli
Our great sponsors
openapi | redocly-cli | |
---|---|---|
2 | 2 | |
359 | 810 | |
1.9% | 5.4% | |
9.8 | 9.3 | |
2 days ago | 2 days ago | |
Ruby | 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.
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.
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?
cardano-python - Python module for handling Cardano cryptocurrency
redoc - 📘 OpenAPI/Swagger-generated API Reference Documentation
plutus-starter - A starter project for Plutus apps
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.
swagger-cli - Swagger 2.0 and OpenAPI 3.0 command-line tool
swagger-markdown - swagger to markdown transpiler
openapi-starter - OpenAPI starter repository
docs-cardano-org - Documentation for Cardano