diff --git a/src/doc/entities.png b/src/doc/entities.png
index ba3e111a78ddec275636ff0b7e8b324edb13f7be..9f0247eb98ca33d4b62168c34ae7d8564f6fc394 100644
Binary files a/src/doc/entities.png and b/src/doc/entities.png differ
diff --git a/src/doc/entities.svg b/src/doc/entities.svg
new file mode 100644
index 0000000000000000000000000000000000000000..63251e31297f4ef480b497a089987e79296f9534
--- /dev/null
+++ b/src/doc/entities.svg
@@ -0,0 +1,310 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="257.60461mm"
+   height="92.070786mm"
+   viewBox="0 0 257.60462 92.070786"
+   version="1.1"
+   id="svg8"
+   inkscape:version="1.0.2 (e86c870879, 2021-01-15)"
+   sodipodi:docname="entities.svg"
+   inkscape:export-filename="/home/daniel/indiscale/software/linkahead/caosdb-server/doc/entities.png"
+   inkscape:export-xdpi="138.03999"
+   inkscape:export-ydpi="138.03999">
+  <defs
+     id="defs2">
+    <marker
+       style="overflow:visible"
+       id="marker1306"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="EmptyTriangleOutM"
+       inkscape:isstock="true">
+      <path
+         transform="matrix(0.4,0,0,0.4,-1.8,0)"
+         style="fill:#ffffff;fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1"
+         d="M 5.77,0 -2.88,5 V -5 Z"
+         id="path1304" />
+    </marker>
+    <marker
+       style="overflow:visible"
+       id="marker1244"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="EmptyTriangleOutM"
+       inkscape:isstock="true"
+       inkscape:collect="always">
+      <path
+         transform="matrix(0.4,0,0,0.4,-1.8,0)"
+         style="fill:#ffffff;fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1"
+         d="M 5.77,0 -2.88,5 V -5 Z"
+         id="path1242" />
+    </marker>
+    <marker
+       style="overflow:visible"
+       id="marker1184"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="EmptyTriangleOutM"
+       inkscape:isstock="true">
+      <path
+         transform="matrix(0.4,0,0,0.4,-1.8,0)"
+         style="fill:#ffffff;fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1"
+         d="M 5.77,0 -2.88,5 V -5 Z"
+         id="path1182" />
+    </marker>
+    <marker
+       style="overflow:visible"
+       id="EmptyTriangleOutM"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="EmptyTriangleOutM"
+       inkscape:isstock="true"
+       inkscape:collect="always">
+      <path
+         transform="matrix(0.4,0,0,0.4,-1.8,0)"
+         style="fill:#ffffff;fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1"
+         d="M 5.77,0 -2.88,5 V -5 Z"
+         id="path1029" />
+    </marker>
+    <marker
+       style="overflow:visible"
+       id="Arrow1Lstart"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="Arrow1Lstart"
+       inkscape:isstock="true">
+      <path
+         transform="matrix(0.8,0,0,0.8,10,0)"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1"
+         d="M 0,0 5,-5 -12.5,0 5,5 Z"
+         id="path866" />
+    </marker>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="0.98994949"
+     inkscape:cx="456.88236"
+     inkscape:cy="211.12615"
+     inkscape:document-units="mm"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1920"
+     inkscape:window-height="1135"
+     inkscape:window-x="0"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:document-rotation="0" />
+  <metadata
+     id="metadata5">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(200.30478,-69.702334)">
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#EmptyTriangleOutM)"
+       d="m -164.37076,125.68023 c 0,0 7.98157,-12.50783 14.18443,-16.03726 16.03406,-9.12339 40.17589,5.10656 52.013732,-9.04239 2.255094,-2.695361 2.46672,-11.843345 2.46672,-11.843345"
+       id="path962"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cssc" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker1244)"
+       d="m -96.257355,126.19649 c 0.965381,-4.15542 1.084194,-8.26873 7.5598,-11.26854 6.807025,-3.15335 7.474053,-2.81327 8.712136,-12.65522 0.438632,-3.486838 0.252106,-13.515495 0.252106,-13.515495"
+       id="path1240"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cssc" />
+    <g
+       id="g41"
+       transform="translate(0,-26.458334)">
+      <rect
+         style="fill:#ffffff;fill-opacity:1;stroke:#000000;stroke-width:1.39511;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+         id="rect835"
+         width="54.226971"
+         height="16.809242"
+         x="-98.980247"
+         y="96.858223" />
+      <text
+         xml:space="preserve"
+         style="font-style:normal;font-weight:normal;font-size:10.5833px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
+         x="-87.690086"
+         y="108.18256"
+         id="text817"><tspan
+           sodipodi:role="line"
+           id="tspan815"
+           x="-87.690086"
+           y="108.18256"
+           style="stroke-width:0.264583">Entity</tspan></text>
+    </g>
+    <rect
+       style="fill:#5bb374;fill-opacity:1;stroke:#000000;stroke-width:1.39511;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect835-3"
+       width="69.995872"
+       height="16.809242"
+       x="-199.60722"
+       y="125.42733" />
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:10.5833px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
+       x="-196.9794"
+       y="136.75168"
+       id="text821"><tspan
+         sodipodi:role="line"
+         id="tspan819"
+         x="-196.9794"
+         y="136.75168"
+         style="stroke-width:0.264583">Record Type</tspan></text>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker1306)"
+       d="m -35.372097,126.19649 c -0.965381,-4.15542 -1.084194,-8.26873 -7.5598,-11.26854 -6.807025,-3.15335 -19.11572,-2.81327 -20.353803,-12.65522 -0.438632,-3.486838 -0.475048,-13.515495 -0.475048,-13.515495"
+       id="path1302"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cssc" />
+    <rect
+       style="fill:#e25b58;fill-opacity:1;stroke:#000000;stroke-width:1.39511;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect835-5"
+       width="49.950661"
+       height="16.809242"
+       x="-115.86278"
+       y="125.42733" />
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:10.5833px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
+       x="-109.21966"
+       y="137.77745"
+       id="text825"><tspan
+         sodipodi:role="line"
+         id="tspan823"
+         x="-109.21966"
+         y="137.77745"
+         style="stroke-width:0.264583">Record</tspan></text>
+    <rect
+       style="fill:#5c6de1;fill-opacity:1;stroke:#000000;stroke-width:1.39511;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect835-7"
+       width="52.356087"
+       height="16.809242"
+       x="-52.16354"
+       y="125.42733" />
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:10.5833px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
+       x="-48.754131"
+       y="136.5889"
+       id="text829"><tspan
+         sodipodi:role="line"
+         id="tspan827"
+         x="-48.754131"
+         y="136.5889"
+         style="stroke-width:0.264583">Property</tspan></text>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker1184)"
+       d="m 33.047535,126.20395 c 0,0 -7.981575,-12.50783 -14.184434,-16.03726 -16.0340604,-9.12339 -52.346724,5.10656 -64.184564,-9.04239 -2.25509,-2.695361 -2.46672,-12.221321 -2.46672,-12.221321"
+       id="path1180"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cssc" />
+    <rect
+       style="fill:#d87ac8;fill-opacity:1;stroke:#000000;stroke-width:1.39511;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect835-6"
+       width="41.932575"
+       height="16.809235"
+       x="13.941126"
+       y="125.42734" />
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:10.5833px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
+       x="25.812365"
+       y="137.77745"
+       id="text833"><tspan
+         sodipodi:role="line"
+         id="tspan831"
+         x="25.812365"
+         y="137.77745"
+         style="stroke-width:0.264583">File</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:6.35px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:center;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
+       x="-164.62788"
+       y="152.51477"
+       id="text1001"><tspan
+         sodipodi:role="line"
+         id="tspan1003"
+         x="-164.62788"
+         y="152.51477">&quot;blue print&quot; </tspan><tspan
+         sodipodi:role="line"
+         id="tspan1005"
+         x="-164.62788"
+         y="160.45227">of data objects</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:6.35px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:center;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
+       x="-90.906052"
+       y="152.51477"
+       id="text1001-5"><tspan
+         sodipodi:role="line"
+         id="tspan843"
+         x="-90.906052"
+         y="152.51477">actual instances</tspan><tspan
+         sodipodi:role="line"
+         id="tspan845"
+         x="-90.906052"
+         y="160.45227">of data objects</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:6.35px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:center;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
+       x="-26.117271"
+       y="152.51477"
+       id="text1001-6"><tspan
+         sodipodi:role="line"
+         id="tspan1050"
+         x="-26.117271"
+         y="152.51477">Records can </tspan><tspan
+         sodipodi:role="line"
+         id="tspan1052"
+         x="-26.117271"
+         y="160.45227">have Properties</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:6.35px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:center;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
+       x="35.023685"
+       y="153.13023"
+       id="text1001-9"><tspan
+         sodipodi:role="line"
+         id="tspan1118"
+         x="35.023685"
+         y="153.13023">representation </tspan><tspan
+         sodipodi:role="line"
+         id="tspan1120"
+         x="35.023685"
+         y="161.06773">of files</tspan></text>
+  </g>
+</svg>