Articles

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.

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.

The main purpose of Platform Software Development Kits and Helper/Client Libraries is to accelerate and simplify development. A well maintained SDK is a trust signal that indicates the level of support and usage of your API for a language, framework, or development platform. In this post, we’ll look at how the developer portals in our research sample included SDKs.

Twilio is regarded as one of the API industry’s leaders, so when, after five years, Twilio changes the documentation format on their developer portal, everybody wants to know why. Jarod Reyes and Andrew Baker (both developers of Twilio's developer education team) gave a presentation about the reason for the changes at SIGNAL 2016. Because we found them valuable and wanted to share them with our developer portal mailinglist, we’ll summarize their findings in this blog post.