The OpenAPI Spec DX Checklist: 18 Things Most Teams Miss
A practical checklist for improving OpenAPI spec quality. These are the exact fields API-Clarity scores — fix them and watch your DX grade climb.
Blog
Practical notes on Shopify app submission prep, approval friction, and reviewer-ready materials.
API-Clarity: Score Your API Documentation Before It Costs You Developers
API-Clarity is an open-source tool that analyzes OpenAPI specs and produces a 0-100 DX score across 5 categories. Here is what it measures and why it matters.
We Scored Stripe, GitHub, and Twilio's API Docs — Here's What We Found
We ran API-Clarity's DX scoring engine against three of the biggest API providers. The results reveal a surprising gap between great APIs and great API documentation.
Fine-Tuned Model Outputs Garbage? Template Mismatch Debug Guide
Your model trained fine but inference fails? Learn how to catch chat template mismatches before wasting GPU hours on debugging the wrong thing.