diff --git a/docs/create-diagram.md b/docs/create-diagram.md
index 6160beb..785260b 100644
--- a/docs/create-diagram.md
+++ b/docs/create-diagram.md
@@ -39,7 +39,7 @@ The following databases are supported:
 - MSSQL
 - Oracle
 
-For the momment the import SQL diagram has not enable for Oracle Data Base.
+For the moment the import SQL diagram has not been enabled for Oracle Data Base.
 
 <ThemedImage
     lightImageSrc={require("./img/light/pick-db.png").default}
@@ -93,7 +93,7 @@ You can define the following fields for an index:
 
 ## Relationships
 
-To create relationships and define foreign keys, click and hold the blue dot on the foreign key column, then drag and drop it onto the primary column. This action follows the logic of `start_col REFERENCES end_col`, where the column you drag from will be designated as the foreign key, linking it to the primary key in the destination column.
+To create a relationship and define foreign keys, click and hold the blue dot on the primary key and drag it to the table with which you want to form the relationship. This will cause a new row to be automatically generated in the child table that will have the primary key information.
 
 <ThemedImage
     lightImageSrc={require("./img/light/create-relationship.gif").default}
@@ -101,17 +101,31 @@ To create relationships and define foreign keys, click and hold the blue dot on
     alt="Create a relationship"
 />
 
-E.g. in the image above, since `posts.user_id` is the foreign key we start dragging from `user_id` to `users.id`.
+The gif shows one of three possible notations selectable in the modeler; for each notation, the rendering and some actions may change.
 
-If at some point you realize that the keys are flipped you can swap them from the `Relationships` tab. Open the relationship you'd like to edit, click on the more button (three dots) next to the primary and forign columns, and then swap.
+<!--If at some point you realize that the keys are flipped you can swap them from the `Relationships` tab. Open the relationship you'd like to edit, click on the more button (three dots) next to the primary and forign columns, and then swap. -->!
+
+To delete the relationship, simply double-click on the relationship and select the delete button or delete the auto-generated foreign key from the table.
 
 You can define the following fields for a relationship:
 
 - Name
+- Relationship type
+    - One to One
+    - One to Many
+    - Subtype
 - Cardinality
-  - One to One
-  - One to Many
-  - Many to One
+    - Only available for One to one
+        - (0,1)
+        - (0,1)
+    - Only available for One to Many
+        - (0,*)
+        - (1,*)
+- Subtype restriction (Only available for Subtype relations)
+    - Disjoint Total
+    - Disjoint Partial
+    - Overlaping Total
+    - Overlaping Partial
 - On Delete Action
 - On Update Action
   - No action
diff --git a/docs/img/dark/create-relationship.gif b/docs/img/dark/create-relationship.gif
index 20f1ffb..d628e31 100644
Binary files a/docs/img/dark/create-relationship.gif and b/docs/img/dark/create-relationship.gif differ
diff --git a/docs/img/dark/define-tables.gif b/docs/img/dark/define-tables.gif
index 1e0e6c7..cadfbc5 100644
Binary files a/docs/img/dark/define-tables.gif and b/docs/img/dark/define-tables.gif differ
diff --git a/docs/img/dark/many-to-many.png b/docs/img/dark/many-to-many.png
index 2938510..0857f4c 100644
Binary files a/docs/img/dark/many-to-many.png and b/docs/img/dark/many-to-many.png differ
diff --git a/docs/img/light/create-relationship.gif b/docs/img/light/create-relationship.gif
index b1c18ac..63a27ce 100644
Binary files a/docs/img/light/create-relationship.gif and b/docs/img/light/create-relationship.gif differ
diff --git a/docs/img/light/define-tables.gif b/docs/img/light/define-tables.gif
index a91afdb..d724d78 100644
Binary files a/docs/img/light/define-tables.gif and b/docs/img/light/define-tables.gif differ
diff --git a/docs/img/light/many-to-many.png b/docs/img/light/many-to-many.png
index 5e69b4a..855cbc7 100644
Binary files a/docs/img/light/many-to-many.png and b/docs/img/light/many-to-many.png differ