Domain models describe how users and stakeholders conceive part of a system or a product in useful detail. Domain models are artifacts, often UML drawings, that enable fruitful collaboration between business and technical people.

For technical communicators, domain models enable higher-level conversations with stakeholders and subject matter experts, inspiring documentation that meets the needs of users effectively.

Domain models can grow into written artifacts that teach part of a business, by complementing the UML diagrams with definitions of concepts, business interactions, motivations, examples, and processes.

The presentation will illustrate how to create domain models by:

• Abstracting technical detail away from technical artifacts, namely UML diagrams for REST APIs.
• Describing business interactions and the concepts seen in those interactions.

The presentation will also share the story of adopting domain models at Farfetch, with both successes and pitfalls.

Reference

Presentation slides

Local copy of the slides for the presentation, stripped from the fashion photos commissioned by Farfetch for the 2023 autumn/winter season.