Enhance Documentation

[niccokunzmann]

When I skip over usage.html, I think, this can be structured in a better way, more descriptive in places and also have more content.

Here is a list of what I think can be improved. For each item, please open a separate pull request.

• change RFC 2445 to 5545 where you can find it
• File structure and overview can be merged.
• SUMMARY: might not be legal in the RFC, check it and make it X-CAL-DESCRIPTION or something used eitherway
• How to open a file with a Calendar object
• How to save a file
• How to add an event
• How to add an event in the local time zone, e.g. using tzlocal
• How to create a recurring event
• How to modify an event in a series
• How to remove an event that happens at a specific time
• How to remove all events in a series
• How to add an alarm to an event
• How to make sure that timezone components are automatically added.
• add() is mentioned but not called
• change pytz occurrences after Transition from pytz to zoneinfo #609 to zoneinfo
• Example heading should be more descriptive of what it actually does
• Overview over components
• Overview over properties
• File Structure could be moved more to the bottom because people might not be interested in it at the start but what to USE the module which is actually the name of the file - maybe it should be moved somewhere else.

See also:

• Remove an event #125
• Feature request: support event deletion #620