From 25e11f8aa9d00e4c7bd5dff1e1e2036a44d272f7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marius=20Bl=C3=BCm?= <marius@lineone.io>
Date: Sun, 27 Jan 2019 23:09:32 +0000
Subject: [PATCH] Calendar Documentation (1)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Marius Blüm <marius@lineone.io>
---
 user_manual/pim/calendar.rst | 100 +++++++++++++++++++++++++++++++++++
 1 file changed, 100 insertions(+)

diff --git a/user_manual/pim/calendar.rst b/user_manual/pim/calendar.rst
index 7272ee556..6e48fdae6 100644
--- a/user_manual/pim/calendar.rst
+++ b/user_manual/pim/calendar.rst
@@ -1,3 +1,103 @@
 ======================
 Using the calendar app
 ======================
+
+The Calendar app is not enabled by default and needs to be installed separately
+from our App Store. Find out more about installing and managing apps over here.
+
+The Nextcloud Calendar app works similar to other calendar applications you can
+sync your Nextcloud calendars and events with.
+
+When you first access the Calendar app, a default first calendar will be
+pre-generated for you.
+
+.. figure:: ../images/calendar_empty.png
+
+Managing your calendars
+-----------------------
+
+Import a Calendar
+~~~~~~~~~~~~~~~~~
+
+If you want to transfer your calendar and their respective events to your Nextcloud
+instance, importing is the best way to do so.
+
+.. figure:: ../images/calendar_import.png
+
+1. Click on the settings-icon labeled with "Settings & Import" at the left-bottom.
+
+2. After clicking on "+ Import Calendar" you can select a calendar file from your
+local device to upload.
+
+3. The upload can take some time and depends on how big the calendar you import
+is.
+
+.. note:: The Nextcloud Calendar application only supports iCalendar-compatible
+          ``.ics`-files, defined in RFC 2445.
+
+Create a new Calendar
+~~~~~~~~~~~~~~~~~~~~~
+
+If you plan to setup a new calendar without transferring any old data from your
+previous calendar, creating a new calendar is the way you should go.
+
+.. figure:: ../images/calendar_create.png
+
+1. Click on ``+ New Calendar`  in the left sidebar.
+
+2. Type in a name for your new calendar, e.g. "Work", "Home" or "Studies".
+
+3. After clicking on the checkmark, your new calendar is created and can be synced
+across your devices, filled with new events and shared with your friends and colleagues.
+
+Edit a Calendar
+~~~~~~~~~~~~~~~
+
+Sometimes you may want to change the color or the entire name of a previous
+imported or created calendar.
+
+.. figure:: ../images/calendar_edit.png
+
+1. Click on the three-dot-menu of the respective calendar.
+
+2. Select ``Edit``
+
+Export a Calendar
+~~~~~~~~~~~~~~~~~
+
+TBD
+
+Delete a Calendar
+~~~~~~~~~~~~~~~~~
+
+TBD
+
+Subscribe to a Calendar
+~~~~~~~~~~~~~~~~~~~~~~~
+
+TBD
+
+Managing Events
+---------------
+
+TBD
+
+Create a new event
+~~~~~~~~~~~~~~~~~~
+
+TBD
+
+Edit an event
+~~~~~~~~~~~~~
+
+TBD
+
+Delete an event
+~~~~~~~~~~~~~~~
+
+TBD
+
+Share your Calendars & Events
+-----------------------------
+
+TBD