Added components feature

docs/components.md

@@ -0,0 +1,37 @@
+# iCalendar Components
+
+Components in iCalendar are used to encapsulate a group of properties (and subcomponents) that
+define a specific type of content. For example, events, to-dos and journals
+are all defined as components of an iCalendar object.
+
+## Calendar Components
+
+Some components may be added directly to an iCalendar object, whereas others are used as
+subcomponents to these top-level components. In iCal4j top-level components are known as
+_Calendar Components_ and extend the `CalendarComponent` abstract class.
+
+| Calendar Components |
+|---------------------|
+| `VEVENT`            |
+| `VTODO`             |
+| `VJOURNAL`          |
+| `VFREEBUSY`         |
+| `VTIMEZONE`         |
+
+
+## Subcomponents
+
+Subcomponents are nested components, and can be multiple levels deep. For example, an
+event may have a nested alarm component, which in turn has a nested location component
+for a proximity trigger.
+
+| Component     | Subcomponents                                     |
+|---------------|---------------------------------------------------|
+| `VEVENT`      | `VALARM`, `PARTICIPANT`, `VLOCATION`, `VRESOURCE` |
+| `VTODO`       | `VALARM`, `PARTICIPANT`, `VLOCATION`, `VRESOURCE` |
+| `VJOURNAL`    | `PARTICIPANT`, `VLOCATION`, `VRESOURCE`           |
+| `VFREEBUSY`   | `PARTICIPANT`, `VLOCATION`, `VRESOURCE`           |
+| `VTIMEZONE`   | `STANDARD`, `DAYLIGHT`                            |
+| `VALARM`      | `VLOCATION`                                       |
+| `PARTICIPANT` | `VLOCATION`, `VRESOURCE`                          |
+

mkdocs.yml

@@ -49,6 +49,7 @@ nav:
   - Features:
     - Parameters: parameters.md
     - Properties: properties.md
+    - Components: components.md
     - Validation: validation.md
     - Compatibility: compatibility.md
     - Date/Time Concepts: datetime.md