Document vRecur property

CHANGES.rst

@@ -7,6 +7,7 @@ Changelog
 Minor changes:
 
 - Add a ``weekday`` attribute to ``vWeekday`` components. See `Issue 749 <https://github.com/collective/icalendar/issues/749>`_.
+- Add ``vRecur`` example to usage documentation. See `Issue 758 <https://github.com/collective/icalendar/issues/758>`_.
 
 Breaking changes:
 
@@ -36,7 +37,7 @@ Minor changes:
 - Merge "File Structure" and "Overview" sections in the docs. See `Issue 626 <https://github.com/collective/icalendar/issues/626>`_.
 - Update code blocks in ``usage.rst`` with the correct lexer.
 - Tidy up the docstring for ``icalendar.prop.vPeriod``.
-- Improve typing and fix typing issues 
+- Improve typing and fix typing issues
 
 
 New features:

docs/usage.rst

@@ -387,11 +387,16 @@ By extending the event with subcomponents, you can create multiple alarms.
     >>> alarm_24h_before.add('description', 'Reminder: Event in 24 hours')
     >>> event.add_component(alarm_24h_before)
 
-Or even recurrence.
+Or even recurrence, either from a dictionary or a string.
+Note that if you want to add the reccurence rule from a string, you must use the vRecur property. Otherwise the rule will be escaped, making it invalid.
 
 .. code-block:: pycon
 
-    >>> event.add('rrule', {'freq': 'daily'})
+    >>> from icalendar import vRecur
+
+    >>> event.add('rrule', {'freq': 'daily', 'interval': 10})
+
+    >>> event.add('rrule', vRecur.from_ical('FREQ=DAILY;INTERVAL=10'))
 
 Write to disk.