diff --git a/CHANGES.rst b/CHANGES.rst
index 72b7a4e..0b304ba 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -8,6 +8,7 @@ Minor changes:
 
 - Add funding information
 - Update windows to olson conversion for Greenland Standard Time
+- Extend examples with alarm + recurrence
 
 Breaking changes:
 
diff --git a/docs/credits.rst b/docs/credits.rst
index e3f8c54..6076c05 100644
--- a/docs/credits.rst
+++ b/docs/credits.rst
@@ -72,6 +72,7 @@ icalendar contributors
 - `NikEasY <https://github.com/NikEasY>`_
 - Matt Lewis <git@semiprime.com>
 - Felix Stupp <felix.stupp@banananet.work>
+- Bastian Wegge <wegge@crossbow.de>
 
 Find out who contributed::
 
diff --git a/docs/usage.rst b/docs/usage.rst
index 7d7aa0c..6f14584 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -309,6 +309,25 @@ Add the event to the calendar::
 
   >>> cal.add_component(event)
 
+Extending the event with subcomponents you can create multiple alarms::
+
+  >>> from datetime import timedelta
+  >>> alarm_1h_before = Alarm()
+  >>> alarm_1h_before.add("action", "DISPLAY")
+  >>> alarm_1h_before.add("trigger", timedelta(hours=-1))
+  >>> alarm_1h_before.add("description", 'Reminder: Event in 1 hour')
+  >>> event.add_component(alarm_1h_before)
+
+  >>> alarm_24h_before = Alarm()
+  >>> alarm_24h_before.add("action", "DISPLAY")
+  >>> alarm_24h_before.add("trigger", timedelta(hours=-24))
+  >>> alarm_24h_before.add("description", 'Reminder: Event in 24 hours')
+  >>> event.add_component(alarm_24h_before)
+
+Or even recurrence::
+
+  >>> event.add('rrule', {'freq': 'daily'})
+
 Write to disk::
 
   >>> import tempfile, os
@@ -330,11 +349,22 @@ Print out the calendar::
   DTEND:20050404T100000Z
   DTSTAMP:20050404T001000Z
   UID:20050115T101010/27346262376@mxm.dk
+  RRULE:FREQ=DAILY
   ATTENDEE;CN="Max Rasmussen";ROLE=REQ-PARTICIPANT:MAILTO:maxm@example.com
   ATTENDEE;CN="The Dude";ROLE=REQ-PARTICIPANT:MAILTO:the-dude@example.com
   LOCATION:Odense\, Denmark
   ORGANIZER;CN="Max Rasmussen";ROLE=CHAIR:MAILTO:noone@example.com
   PRIORITY:5
+  BEGIN:VALARM
+  ACTION:DISPLAY
+  DESCRIPTION:Reminder: Event in 1 hour
+  TRIGGER:-PT1H
+  END:VALARM
+  BEGIN:VALARM
+  ACTION:DISPLAY
+  DESCRIPTION:Reminder: Event in 24 hours
+  TRIGGER:-P1D
+  END:VALARM
   END:VEVENT
   END:VCALENDAR
   <BLANKLINE>