The top three reasons I love docs-as-code
At Redocly, we embrace developer experience. We believe docs-as-code is the optimal developer experience for producers of APIs.
From ReDoc to Redoc.ly
As you probably know ReDoc was developed by Rebilly which is a payment/subscription company. Their main product is an API and it has a lot of endpoints and advanced payloads.
OpenAPI 3
A few weeks ago, we migrated three API definitions that I maintain and contribute to OpenAPI 3 from Swagger 2. It is relatively easy to transition from version 2 to 3.
API-first design
The background… By the time ReDoc was released in 2015, I was more comfortable with the OpenAPI (fka Swagger) specification.
Hello world, our mission is to perfect the API Developer Portal
ReDoc was born out of frustration with rendering my OpenAPI definitions for API reference docs. Developer documentation is very important to a developer’s experience.