How spec-first API documentation aids partner integration
Bill Doerrfeld | November 29, 2024
Using a source of truth can greatly benefit partner API integrations.
Having good API documentation is one thing. Being specification-first is next level. My latest post on the Bump.sh blog looks into the benefits a specification-driven, git-based approach to documentation can bring to partner API integrations.
The idea is that by using a source of truth and focusing on documentation earlier in the pipeline, API providers can produce more accurate, detailed descriptions and evolve their service more effectively. This can benefit discovery and resolve drift, equating to a better partner experience.
If you're an API provider opening your API to partners, definitely check out this one for some solid reasons why spec-driven documentation should be at the forefront.
AI researchers are calling the next class of models large action models (LAMs). For The New Stack, I explored what LAMs are, what examples are emerging in the market, and what experts think.
My article for LeadDev explores specific prompting techniques proven to sharpen your AI-assisted software development.
Nordic APIs, the API-specific blog I edit, was recently ranked the top API blog online by FeedSpot. After ten years managing this presence, I reflect a bit on the journey thus far.
Developers are realizing that being productive with AI coding assistants takes a lot more than just asking nicely. There's real craft to it.
AI coding is the easy part. Now it's time to focus on DevOps to get it into production. In a recent interview for LeadDev's DirectorPlus, Honeycomb's CTO, Charity Majors, shares expert tips on how to accomplish this.
My latest for The New Stack explores new research from Ai2, DataDecide, which helps LLM developers make better decisions around training data.
My APISEC|CON talk covers the hype around agentic AI and MCP, and delves into inherent flaws in MCP architectures and suggests mitigations.
AI coding assistants are a productivity dream in some cases — and a debugging nightmare in others. So, where’s the line?
Semantic caching is like typical caching, but for AI. It could eliminate a lot of redundant API calls to LLMs, reducing costs and improving performance.
For CIO.com, leading executives shared with me how they're actively utilizing agentic AI to enhance core business workflows.
