Articles
Categories
How MCP Implementation Patterns Shape Developer Portal Information Architecture
Different MCP implementation patterns lead to different developer portal information architecture and publishing strategies. Rather than introducing a separate MCP portal, organizations can evolve their developer portal CMS to model new interface types alongside existing APIs, preserving a coherent organizational layer for discovery, governance, documentation, and AI-facing interfaces.
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.
Manage Multiple Organizations in Apigee: Multi-Org Benefits, Use Cases, and Best Practices
How can your different teams manage their preferred gateways while maintaining consistent oversight, documentation, and user experience across the enterprise? Across different multi-org setups, our approach enables a single developer portal. We outline three practical multi-org scenarios in their essence, which we can apply to your use case, be that with several Apigee instances or multiple gateways.
How a holistic approach to user experience and technical writing can drive AI-readiness
What is the importance of aligning UX and technical writing practices, especially as generative AI becomes part of the developer experience? Through practical examples, we argue that shared ownership of UX and technical writing is crucial to build AI-ready, future-proof developer portals.
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.
Internationalization and Localization on Developer Portals
Effective localization drives global growth and boosts competitiveness. In this article, we dive deep into the importance of translation and localization and introduce how Drupal can enhance content comprehension and provide a smooth and engaging experience with features like RTL layout adjustments or UTF-8 compatibility.
