Intermediate–Advanced 6 topic areas 95+ exercises

Platform Engineer / IDP

Platform engineers sit at the intersection of infrastructure and developer experience. You write proposals, present roadmaps, and convince sceptical teams to adopt new golden paths — all in English. This path builds the vocabulary to talk about IDP architecture, DORA metrics, and platform-as-product strategy clearly and persuasively, whether you are writing a Backstage component YAML comment or presenting a deprecation notice to a hundred engineers.

Topics covered

  • golden paths
  • IDP architecture
  • developer portals
  • self-service infrastructure
  • cognitive load reduction
  • DORA metrics

Vocabulary spotlight

4 terms every Platform Engineer / IDP should know in English:

IDP n.

Internal Developer Platform — a self-service layer that lets product teams provision infrastructure without involving platform engineers directly

"Our IDP reduced mean time to provision a new service from three days to 20 minutes."
golden path n.

The opinionated, supported route for building and deploying services, designed to encode best practices by default

"If you follow the golden path, security scanning and observability are already wired in."
Backstage n.

An open-source developer portal framework from Spotify used to catalog services, templates, and documentation

"We use Backstage as the front door to our IDP so engineers can discover every internal service."
cognitive load n.

The mental effort required to understand or operate a system; a key metric for platform team success

"Reducing cognitive load for application developers is the north star for our platform team."
paved road n.

A synonym for golden path; emphasises that the recommended route is smooth and well-maintained

"We want teams to feel the paved road is easy enough that deviating is rarely worth it."
scaffolding n.

Automated code or configuration generation that creates the skeleton of a new service from a template

"Run the scaffolding command and you will get a repo with CI, logging, and a health endpoint pre-configured."
Open full glossary →

📚 Vocabulary Reference

Key terms organised by category for Platform Engineer / IDPs:

IDP Concepts

internal developer platformgolden pathpaved roadself-servicedeveloper portalplatform-as-productplatform teamcognitive loadthinnest viable platformteam topologies

Tooling

Backstagescaffoldingsoftware templatecomponent catalogTechDocsservice meshHelm chartArgoCDCrossplaneTerraform module

Metrics

DORA metricsdeployment frequencylead time for changeschange failure ratetime to restore serviceplatform adoptiondeveloper satisfactiononboarding timetoil reductiongolden path adoption rate

Operations

runbookplaybookon-call rotationalert fatigueobservabilitySLOSLAerror budgetincident responsepost-mortem
Study full vocabulary modules →

Recommended exercises

Real-world scenarios you'll practise

  • Writing a Backstage component YAML and explaining the metadata fields to a new contributor.
  • Presenting the platform roadmap to product teams and handling pushback about migration timelines.
  • Explaining the golden path concept to a sceptical senior engineer who prefers full control.
  • Writing a platform deprecation notice that gives teams enough context to migrate without feeling ambushed.

Recommended reading

Explore another role

🥽 AR / VR / XR Developer

Open path →