diff --git a/documentation/DVBpy Classes.dia b/documentation/DVBpy Classes.dia
new file mode 100644
index 0000000..3e8c0c1
Binary files /dev/null and b/documentation/DVBpy Classes.dia differ
diff --git a/documentation/DVBpy Classes.png b/documentation/DVBpy Classes.png
new file mode 100644
index 0000000..7b0d8af
Binary files /dev/null and b/documentation/DVBpy Classes.png differ
diff --git a/documentation/Docs.md b/documentation/Docs.md
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/documentation/Docs.md
@@ -0,0 +1 @@
+
diff --git a/dvb/models.py b/dvb/models.py
index 40167bc..ebfb454 100644
--- a/dvb/models.py
+++ b/dvb/models.py
@@ -31,8 +31,8 @@ class Departure:
     """A single upcoming departure from a stop."""
 
     id: str
-    line: str
-    direction: str  # destination name
+    line: str # e.g. 3, 8, RE80
+    direction: str  # Most commonly name of last Station
     scheduled: datetime
     real_time: datetime | None = None
     state: str = ""  # real-time state, e.g. "InTime", "Delayed"
@@ -62,9 +62,9 @@ class PartialRoute:
     """A single leg of a planned route, e.g. one tram ride within a multi-transfer journey."""
 
     duration: int  # in minutes
-    line: str
+    line: str # e.g. 3, 8, RE80
     mode: str  # e.g. "Tram", "CityBus", "Footpath", "StayForConnection"
-    direction: str
+    direction: str # Most commonly name of last Station
     stops: list[RegularStop]
     cancelled: bool = False
     changeover_endangered: bool = False  # transfer to the next leg is at risk