Hello!

My initial build script tried to update the OAS for my API, copy it to the docs repo, AND regenerate the SDK. Very messy. Messy indeed.

The fix: let each repo do one thing.

• API repo: Update the OAS.
• Docs repo: Generate reference docs from the OAS with Redoc.
• SDK repo: Use the OAS to regenerate the SDK with Speakeasy.

Now when I make changes to the API, I just update the schema and commit it. When I want to regenerate the SDK, I go to the SDK repo and run speakeasy run. Separation of concerns. Whoop whoop

So my CLI rejected an OAS file because it had structural issues but I couldn’t see what the issues were. I spent forever trying to fix the OAS file. No bueno.

We’re just gonna pipe the output to a log file and move on. This way users can still see the issues but it won’t block the analysis.