Explain like I'm five · SW Eng

What is Writing UML Diagrams?

UML diagrams, told as a story about drawing a design map before writing a book — a character relationship map, a sequence of events, a list of what readers can do.

writing without a map, the characters' relationships got tangledeven the writer lost track, too late, of who was whose sibling

Writing straight in without a map, the characters' relationships got tangled.Even the writer lost track, too late, of who was whose sibling.

spend that drawing time just writingno diagram, no way to explain this structureexplained only in words, no one else pictures the same thing

The editor says to just write; the writer objects that the structure can't be explained without a diagram.Explained only in words, no one else pictures the same thing.

THE MAP DRAWN BEFORE WRITINGrelationship map — how characters relatesequence — the order events happen inuse-case list — what readers can doUML diagrams = a design map that draws out the structure in pictures, before writing beginsusing agreed-upon symbols to show clearly a structure that's hard to explain in words

UML diagrams are the design map drawn before writing.Agreed-upon symbols show clearly a structure that's hard to explain in words.

Draw out the relationshipsconnecting characters with lines
Draw out the sequenceshowing the order events happen in
Draw out the use caseslaying out what readers can do
Draw out the state changesshowing how a character's state changes over time
FOUR COMMON UML DIAGRAMSclass diagram — character relationship mapsequence diagram — the order events happen inuse-case diagram — what readers can dostate diagram — how a character's state changeseach diagram shows something different — no single one covers it alldrawing the diagram doesn't automatically make the structure good

Commonly used UML diagrams are the class, sequence, use-case, and state diagrams.Each diagram shows something different — no single one covers it all.

UML shows the structure clearlybut actually writing the book is still up to the writerUML is just the map drawn before writing — drawing it doesn't write the book for you

Drawing the map doesn't write the book for you.UML is just the map drawn before writing.

In one breath

UML diagrams = an agreed-upon design map that draws out the structure in pictures, before writing begins.

UML (Unified Modeling Language) is a modeling language that expresses software structure and behavior through standardized symbols. A class diagram shows static relationships between components, a sequence diagram shows interactions over time, a use-case diagram shows what a user can do with the system, and a state diagram shows how an object's state changes. It's used to share and review a design before any code is written.

When grown-ups say it

UML
The agreed-upon system of diagram symbols. Draws structure and behavior in standardized symbols.
Class Diagram
The relationship map between characters. Shows the static structure.
Sequence Diagram
A diagram of the order events happen in. Shows interaction over time.
Use-case Diagram
The list of what readers can do. Lists functions from the user's point of view.
State Diagram
A diagram showing how a character's state changes. Tracks how an object's state changes.
Requirements Engineering
Asking before writing. UML also makes the outline even clearer, in picture form. → the one who asks before writing
GoF Design Patterns
The book of proven writing formulas. A class diagram is used to draw a pattern out visually. → the book of proven writing formulas
Software Architecture Model
The structural blueprint for the whole book, drawn ahead of time. Borrows UML notation even when drawing a much larger structure.
Next story
The Ruler That Measures Functions, Not Pages →
Want another term as a picture book? Request →