Articles

The 2026 Developer Portal Awards are now open for nominations. This year’s programme focuses on four complementary perspectives that reflect the questions we see organisations grappling with today: managing large API portfolios, presenting API products in their business context, documenting API data products, and rethinking onboarding experiences. Rather than prescribing a single model of excellence, the awards recognise observable examples of thoughtful developer portal design across different operating models and organisational contexts.

Organizations usually know what their APIs make possible. They are often much less certain that the outside world understands the same thing. This article follows what happens as technical documentation, developer portals, solution content, and business language gradually drift apart. It considers why that matters for developers, partners, buyers, and AI-assisted discovery, why API teams often notice the problem first, and why making those relationships legible is becoming part of business leadership rather than documentation alone. 

In AI-mediated hybrid workflows, developer portals act simultaneously as product marketplaces and technical workbenches. Cross-dependency is reduced during discovery, but not in organizational commitment. Developer portals evolve to support hybrid human-AI evaluation with accessible, machine-legible, and authoritative documentation for both technical and business stakeholders.

As autonomous agents increasingly interact with technical documentation, traditional HTML can introduce challenges by filling limited context windows with layout elements, navigation, and scripts. This structural cluttering not only drains computing resources but directly causes context pollution and AI hallucinations. Discover how you can reduce this “token tax” and create cleaner, more AI-friendly documentation experiences.

Intent-driven search is transforming API marketing. Learn how solution portals help to improve discovery, engagement, and sales through AI search in frontier models.

Economic buyers may not be fully aware of the business value of quality content, and you need to explain in detail to get budget approval for your developer content improvements. This article outlines common concerns and provides business-focused arguments to resolve them. We emphasize that content quality impacts trust, speed, and user experience, it will ultimately affect  business goals like adoption and retention. This article is for you if you want to learn to frame content improvements in terms of business impact, and to collaborate with relevant teams to measure and demonstrate success, even with limited resources.