~/devreads

#api documentation

6 posts

9 Jun

9 Apr

3 Mar

Art Anthony 6 min read

In years gone by, API specifications and developer portals were created for developers’ eyes only. It wasn’t unusual for them to include the occasional joke or pop culture reference, or omit context that any qualified API consumer would easily be able to infer. While the introduction of standards like OpenAPI has already systematized and sanitized ...

blogai agentsapi designapi documentationapi standards

7 Jan

J Simpson 6 min read

In OpenAPI, the industry standard API specification, small steps can have major implications. While OpenAPI 3.2.0 may not reinvent the wheel, as it still follows the same architecture and uses the JSON Schema Specification Draft 2020-12 implemented in OpenAPI 3.1.0, OpenAPI Specification v3.2.0 still has enough changes to warrant excitement while remaining compatible with older ...

blogdesignapi designapi documentationapi governance

24 Dec 2025

Art Anthony 9 min read

For as long as most of us can remember, “developer experience” has been the umbrella term when it comes to measuring the usability, reliability, and effectiveness of APIs. A great developer experience, meaning one that makes things straightforward and reduces friction as much as possible, is the gold standard. Get your DX right, and word ...

blogstrategyai agentsapi designapi documentation

25 Nov 2025