diff --git a/api/README.md b/api/README.md
index 256600c5..942cba07 100644
--- a/api/README.md
+++ b/api/README.md
@@ -2,6 +2,8 @@
 
 ## Database schema
 
+The many-to-many relation between entries (episodes/movies) & videos is NOT a mistake. Some video files can contain multiples episodes (like `MyShow 2&3.mvk`). One video file can also contain only a portion of an episode (like `MyShow 2 Part 1.mkv`)
+
 ```mermaid
 erDiagram
     shows {