Demo: document a login sequence with PlantUML
PlantUML is strong when a diagram needs to live beside code. A compact sequence source can explain authentication, token exchange, and failure handling without drawing by hand.
- Name participants exactly as they appear in the system boundary.
- Keep messages short enough for review comments and wiki pages.
- Use alt blocks for expected failure paths instead of writing them only in prose.
@startuml
actor User
participant Web
participant Auth
database SessionDB
User -> Web: submit credentials
Web -> Auth: verify password
Auth -> SessionDB: create session
Auth --> Web: token
Web --> User: signed in
@enduml