"TypeSpec is an attempt to combine the design-first and code-first worlds into something that works across both methodologies and reduces cognitive load for designers. ... The TypeSpec approach also means a general decrease in complexity, which, for Microsoft, eases its use across the organization." -- #ChrisWood
#APIs#APIAsAProduct#APIManagement#SoftwareDevelopment#APITesting#APIDesign#APIDocumentation: "I often make the point about API users that they fall into one of two buckets: the conceptual user (the dreamer) and the procedural user (the implementer). Breaking those two down is a blog post for another day, but essentially, this book is aimed at both, leaning more heavily toward the former.
Bruno embarked on his book-writing journey armed with a hefty dose of product thinking. He took the scenic route chatting it up with API aficionados, getting the lowdown of their challenges and triumphs. Turns out, we Product Managers are drowning daily in a sea of technical jargon without a life raft in sight.
If you’re anything like me back in the day, when I was a fresh-faced newbie diving headfirst into the API industry, you’ll relate. I’m talking fingers dancing across the keyboard like they were in some kind of turbocharged typing marathon during every single sit-down with architects, developers, and engineers. Seriously, the clickety clack of the keystrokes echoed as my own personal symphony: Reverie of Desperate Recall.
"An API should be easy to learn and write to, and hard to misuse. Your API will also need to evolve, and a good design takes this into account." -- #CharlesHumble
Learn all about Redocly the handy OpenAPI documentation tool with a Swiss army CLI that does everything (even linting!), and a bit more about the plan for OpenAPI v4 (a.k.a Moonwalk).
Good natter in general with @lornajane who I always love catching up with.
Undisturbed REST: a Guide to Designing the Perfect API by Nomad PHP and Mike Stowe is on sale on Leanpub! Its suggested price is $24.95; get it for $9.71 with this coupon: https://leanpub.com/sh/Pf6eJSiK#ApiDesign