Why I'm using file based refs, and you should be to.
Take any API, document that API in enough detail, and the OpenAPI specification will sprawl.
The OpenAPIGuy Blog
A place to share my knowledge about OpenAPI and how best to use (and abuse) it.
Inside OpenAPI
What is the point of OpenAPI?
Build absolutely anything from a standardized definition
OpenAPI documents open up the whole new worlds of DevEx.Automation
Generate your OpenAPI specifications from server side frameworks like FastAPI, Flask, etc...
Documentation
Generate comprehensive API documentation using OpenAPI with platforms like Mintlify, Scalar, Docusaurus, etc...
SDKs
Generate SDKs for your API with platforms like Speakeasy, etc...
Contract Testing
Test your API contracts with platforms like Pact, TestContainers, etc...
Read the blog for more
View all posts »OpenAPI centric content
Hello World!
I've had the absolute privilege of working on dozens of OpenAPI Specs and I'm excited to share my thoughts and experiences with you all through this blog.
GitHub Stats
1613
Repo Views
173
Stars
28
Forks
2600
Total Contributions
Updated at: 7/17/2024, 12:08:47 PM