diff --git a/src/bo4e/com/zeitraum.py b/src/bo4e/com/zeitraum.py
index 3495c5157..7b0961260 100644
--- a/src/bo4e/com/zeitraum.py
+++ b/src/bo4e/com/zeitraum.py
@@ -33,12 +33,35 @@ class Zeitraum(COM):
     """
 
     startdatum: Optional[date] = None
-    """Startdatum, inklusiv"""
+    """Startdatum des betrachteten Zeitraums ist **inklusiv**.
+
+    Example:
+        '2025-01-01'
+    """
     enddatum: Optional[date] = None
-    """Enddatum, inklusiv"""
+    """Enddatum des betrachteten Zeitraums ist **inklusiv**.
+
+    Example:
+        '2025-01-01'
+    """
     startuhrzeit: Optional[time] = None
-    """Startuhrzeit, inklusiv mit Zeitzone"""
+    """Startuhrzeit mit Zeitzone. Die angegebene Uhrzeit ist im betrachteten Zeitraum **inklusiv**.
+
+    Example:
+        '18:00:00+01:00'
+    """
     enduhrzeit: Optional[time] = None
-    """Enduhrzeit, exklusiv mit Zeitzone"""
+    """Enduhrzeit mit Zeitzone. Die angegebene Uhrzeit ist im betrachteten Zeitraum **exklusiv**.
+
+    Example:
+        '19:00:00+01:00'
+    """
     dauer: Optional[str] = None
-    """Dauer in ISO 8601 , example: 'P1DT30H4S', siehe https://datatracker.ietf.org/doc/html/rfc3339 """
+    """
+    Dauer in ISO 8601 Format.
+
+    Example:
+        'P1DT30H4S'
+
+    See `RFC 3339 <https://datatracker.ietf.org/doc/html/rfc3339>`_
+    """