Using UML Combined Fragments to Document API Error Paths Without Diagram Bloat
API contracts often bury error handling in prose or separate diagrams. UML 2.x sequence diagram combined fragments—alt, opt, loop, and break—let you encode conditional branches, optional side effects, and bounded retries in one readable specification, provided you respect density limits.