The API consultant James Higginbotham wrote recently about the advantages of adopting an API design-first approach using the “Align-Define-Design-Refine” (ADDR) process. ADDR is an iterative ...

Encourage your API designers to use this approach to not only add documentation in the main body of an API design, but also in any libraries you use. There’s a lot to like in Cadl.

The most successful API projects take what I call a “design-first” approach. Fundamentally, design-first is about creating an experience that delights your audience.

Ministry of Economy, Trade and Industry (METI), Japan and Digital Architecture Design Center of Information-Technology Promotion Agency (IPA DADC), Japan, has jointly published a technical reference ...