uml/deployment-diagram.md

-**Sources:** http://www.omg.org/spec/UML/2.5
+**Sources:** http://www.omg.org/spec/UML/2.5 (Starting at page 693)
 
 # Usage Scenarios
-The *deployment diagram* is used to ...
+The **deployment diagram** is used to describe deployment relationships between artifacts and targets, i.e. which target deploys which artifact. We distinguish *instance* and *type* level deployment relationships (p. 694, first paragraph).
 
 ---
 
 # Examples
-## Flat example
+Below you can find two different approaches for modelling a deployment of the previously defined [component diagram](https://git.informatik.uni-kiel.de/ag-se/teaching-public/wikis/uml/component-diagram).
+
+## Black box example
 ![deployment-flat.svg](/uploads/3a70e7f973c3a71e68772562e9613acd/deployment-flat.svg)
 
-## Hierarchic and distributed example
+## Distributed example
 ![deployment-hierarchy.svg](/uploads/a79207fc8b240923e5e660e4e12ceac3/deployment-hierarchy.svg)