Documentation

Building an AI tool to review API design taught us something fundamental about how AI approaches quality: it confidently optimizes for the least important parts. Instead of flagging the quality issues that actually hurt developers, like confusing workflows, hidden rules, or inconsistent mental models, it focused on the safe, measurable stuff: naming patterns, formatting mistakes, even typos. Developer experience issues just didn’t get caught, even though in our case, we speci

Wix’s Velo API reference contains over 2,000 code samples. About a year ago, we introduced a syntax change to Velo that suddenly...

User experience is crucial for APIs, as it directly impacts how easily developers can integrate, utilize, and build upon the provided...