Articles
Everything on developer portals from strategy and business to technology and visual design.
Sign up to our newsletter to make sure you don't miss out.
Categories
by 6 months ago
How to Serve Markdown to AI Agents Without Breaking Your SEO
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 for API Marketing
Intent-driven search is transforming API marketing. Learn how solution portals help to improve discovery, engagement, and sales through AI search in frontier models.
Struggling to get buy-in? Ten ways to make the business case for content improvements
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.
Make your Developer Portal Ready for AI Agents
Pronovix open-sources a Drupal Recipe to make developer portals AI-ready with llms.txt support. This solution provides LLM-friendly Markdown content, reducing processing costs and enhancing clarity for AI agents.
Discoverability, Findability, and AI: Lessons from the Developer Portal Awards
What does discoverability and findability mean in the context of developer portals? What can we learn from standout API portals doing it right? Beyond offering practical examples and inspiration from among the award nominated portals of the past two years, this article also carries a core philosophical message: user intent is the crux, never lose sight of it.
5 practical actions toward AI-readiness
A strategic, well-structured approach can enhance your content’s usability, discoverability, and value for both developers and AI tools. In this article, we outline five practical steps, from prioritization to metadata strengthening, to help make your content AI-ready.