Blog Layout
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.
The 2nd annual code quality report from GitClear found 10x more duplicated code than two years ago and fewer signs of code reuse than ever before.
My feature on InfoWorld explores the state of Kubernetes usability, highlighting various advancements across workload types, support for edge and AI, and new features like observability and security.
It's up to leadership to help prioritize large-scale engineering updates that keep software running smoothly. Kent Wills, Director of Engineering at Yelp, provides insight on the latest DirectorPlus.
Italian for “tapestry,” Arazzo is aptly named since it can be used to weave together sequences of API calls to illustrate a specific business pattern.
I caught up with CTO Itiel Shwartz about leveraging finely tuned models like Komodor’s KlaudiaAI agent for ultra-specific DevOps challenges, like Kubernetes error diagnosis and remediation challenges.
Rolling out AI is all about framing it in a positive light, says GitLab's CTO, Sabrina Farmer. I interviewed her for the latest edition of DirectorPlus for LeadDev, which is out today.
Surmounting risks are encouraging CIOs to future-proof and update their resilience strategies. My latest feature for CIO.com explores resilience head-on.
Today, DX debuted a new developer productivity framework, DX Core 4. Excited to break the news with LeadDev, interviewing one of the designers of the framework.
In this issue of DirectorPlus, Gus Fune shares the story behind reverse engineering a monolithic e-commerce platform following MACH principles, which stands for microservices, APIs, cloud-native, and headless.
75% of APIs stray from their OpenAPI specifications. My feature explores why API drift is so common and how engineering leaders should mitigate this issue.
