Developer Portal
ELI5 — The Vibe Check
A Developer Portal is a one-stop shop for everything developers need: API docs, service catalog, onboarding guides, templates, and tools. Instead of asking 'where's the docs for the payment service?' you check the portal. It's the internal Wikipedia for your engineering org.
Real Talk
Developer portals (Backstage, Port, Cortex) provide a centralized interface for service catalogs, API documentation, CI/CD status, ownership information, and self-service templates. They reduce cognitive load, improve discoverability, and standardize developer workflows across the organization.
When You'll Hear This
"Backstage shows every service, its owner, its docs, and its deploy status in one place." / "New developers use the portal to find APIs, create new services, and understand our architecture."
Related Terms
Golden Path
A Golden Path is the recommended, well-supported way to do something in your organization. Need a new service? Follow the Golden Path template.
Internal Developer Platform
An Internal Developer Platform (IDP) is the self-service layer that lets developers deploy, monitor, and manage their apps without bugging the ops team.
Platform Team
A Platform Team builds internal tools and infrastructure so product teams can ship faster.