Skip to main content

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.

by Christoph Weber 1 month 4 weeks 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.
Categories: AI, Technical Solutions
by Dezső Biczó 7 months 3 weeks ago

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. 
by Kathleen De Roo , Ádám Balogh 10 months 2 weeks ago

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.
Categories: AI, Technical Solutions
by Laura Vass 11 months 2 weeks ago

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.
by Dezső Biczó 11 months 3 weeks ago

Recipe Code Installer: Bridging the gap between configuration and functionality

Recipe Code Installer bridges the gap between Drupal's Recipes and custom modules. It lets Recipes include custom PHP code that becomes a module, overcoming the limitation of Recipes not having their own code. This simplifies development, provides more control, and reduces external dependencies for both creators and adopters.

Newsletter

Articles on devportals, DX and API docs, event recaps, webinars, and more. Sign up to be up to date with the latest trends and best practices.

 

Subscribe