database serialization: diagrams

dmlex-v1.0/specification/serializations/RDB/databaseDiagrams/etymology.drawio

@@ -1 +1 @@
-<mxfile host="Electron" modified="2023-08-19T15:55:33.563Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/20.3.0 Chrome/104.0.5112.114 Electron/20.1.3 Safari/537.36" etag="CtaF4uOgUQqGKUXkn79G" version="20.3.0" type="device"><diagram id="R2lEEEUBdFMjLlhIrx00" name="Page-1">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</diagram></mxfile>
+<mxfile host="Electron" modified="2023-08-19T17:20:26.886Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/20.3.0 Chrome/104.0.5112.114 Electron/20.1.3 Safari/537.36" etag="0IUA9s2v68zaY-f-5oTe" version="20.3.0" type="device"><diagram id="R2lEEEUBdFMjLlhIrx00" name="Page-1">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</diagram></mxfile>

dmlex-v1.0/specification/serializations/RDB/specification.xml

@@ -28,6 +28,65 @@
     </itemizedlist>
   </section>
 
+  <section role="informative">
+    <title>Database diagrams</title>
+    <para>
+      The following diagrams provide a high-level overview of the relational database serialization of DMLex.
+      Each diagram presents a "view" of the database from the perspective of one of the modules or from the perspective of the DMLex Core.
+      The diagrams shown here follow the usual conventions used in relational database diagrams:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>Each box represents a database table and contains a list of its column headings.
+          The abbreviation PK next to a column name indicates that the column is a primary key.
+          The abbreviation FK next to a column name indicates that the column is a foreign key.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Lines between the boxes represent relationships between tables,
+          with the conventional "crow's feet" symbols at the ends of the lines
+          to indicate the relation's arity (one-to-many etc.).
+        </para>
+      </listitem>
+    </itemizedlist>
+    <para>In addition to that, the following non-standard conventions are used in the diagrams:</para>
+    <itemizedlist>
+      <listitem>
+        <para>A curly bracket surrounding a group of foreign keys in a table indicates the constraint
+        that exactly one of the foreign keys in this group must be non-empty while all the other ones must be null.</para>
+      </listitem>
+      <listitem>
+        <para>Tables and columns shown in grey are tables are defined in another module (or in the core)
+        and are shown only for information.</para>
+      </listitem>
+    </itemizedlist>
+    <section>
+      <title>Database diagram: DMLex Core</title>
+      <graphic fileref="serializations/RDB/databaseDiagrams/core.svg" contentwidth="16cm"/>
+    </section>
+    <section>
+      <title>Database diagram: DMLex Crosslingual Module</title>
+      <graphic fileref="serializations/RDB/databaseDiagrams/xlingual.svg" contentwidth="16cm"/>
+    </section>
+    <section>
+      <title>Database diagram: DMLex Controlled Values Module</title>
+      <graphic fileref="serializations/RDB/databaseDiagrams/values.svg" contentwidth="16cm"/>
+    </section>
+    <section>
+      <title>Database diagram: DMLex Linking Module</title>
+      <graphic fileref="serializations/RDB/databaseDiagrams/linking.svg" contentwidth="16cm"/>
+    </section>
+    <section>
+      <title>Database diagram: DMLex Annotation Module</title>
+      <graphic fileref="serializations/RDB/databaseDiagrams/annotation.svg" contentwidth="16cm"/>
+    </section>
+    <section>
+      <title>Database diagram: DMLex Etymology Module</title>
+      <graphic fileref="serializations/RDB/databaseDiagrams/etymology.svg" contentwidth="16cm"/>
+    </section>
+  </section>
+
   <section id="RDBTables" role="normative">
     <title>DMLex relational database serialization tables</title>
     <xi:include href="tables/lexicographicResources.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>