Cheat notes · Module 01 · The product and its people
What a platform is, and platform as a product
A five-minute review for when you have done this module and want it back in your head. Open the full module for the steps and the lab, or the full text to print.
The idea
A platform is defined by its users and their problems, not by its tools, and it is run as a product: an owner, evidence, a roadmap and the courage to say no.
Remember
- Platform as a product is the first of seven attributes in the CNCF Platforms White Paper.
- Bottcher (2018): "a foundation of self-service APIs, tools, services, knowledge and support which are arranged as a compelling internal product".
- Thinnest viable platform: just enough capability without unnecessary complexity (Team Topologies).
- A mission is an outcome for users; a roll-out of tools is a project (rule
P2). - Every problem needs evidence: where you heard or measured it (
P5). - Non-goals let a small team say no without arguing again (
P6).
Pitfalls
- A mission that names a tool ("roll out Backstage") fails
P2and tells users nothing. - Problems without evidence build a platform nobody asked for.
- Confusing the portal with the platform: a portal is one interface among thirteen capability areas.
platform.yaml (part)
mission: >-
A product team goes from an idea to a safe change in production in one day,
without waiting for another team, and an agent can do the routine part of that work inside the same limits.
owner: platform
productOwner: Platform product manager (platform team)
Test yourself
Answer in your head first, then open the answer.
Name three things a platform is often confused with.
A developer portal, a tool, a project (or a ticket desk).
What makes a platform a product?
Users with known problems, an owner who decides what comes next, and adoption by choice.
Why write non-goals?
So the team can say no consistently and stay small.
Where module 01 leaves you: platform.yaml in your repo passes the check (ok platform.yaml). It names two users of kind human, each with problems and evidence, the owner platform, a product owner and three non-goals.