From da66a752db0914660e86a87e89b824cb0d7bd3c0 Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Mon, 8 Aug 2016 17:56:50 +0200
Subject: Restructure to new file naming convention.

---
 USE.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 USE.md

(limited to 'USE.md')

diff --git a/USE.md b/USE.md
new file mode 100644
index 0000000..b8767b7
--- /dev/null
+++ b/USE.md
@@ -0,0 +1,56 @@
+# Calendaring introduction
+
+Anyone can read calendars shared publicly at [[!template id=realm]].
+
+Your personal [[account]] grants read-only access to closed-group shared calendars.
+
+Custom group accounts provide write access to (closed-group or public) shared calendars.
+
+
+## Clients
+
+Recommended calendaring client depends on the operating system you use:
+
+  * Mac, iPhone and iPad: Apple Calendar
+  * Windows and Linux: [Mozilla Lightning](https://www.mozilla.org/en-US/projects/calendar/)
+  * Android: [DAVdroid](https://f-droid.org/app/at.bitfire.davdroid)
+    and [ICSdroid](https://f-droid.org/app/at.bitfire.icsdroid)
+
+
+## Security
+
+Before you setup any password-protected calendars,
+make sure to install the [CACert.org security certificate](http://wiki.cacert.org/FAQ/BrowserClients).
+
+
+## Read-only access
+
+When you only need to read a calendar,
+the best (most efficient) is to subscribe to an **iCal** calender:
+
+ 1. Copy address of relevant calendar from web page
+    <http://[[!template id=eventhost]]/>.
+ 2. Open calendaring client, and add new account profile of type "ical".
+ 3. Paste the calendar address as server address.
+
+Closed-group calendars also require username and password,
+and require a secure connection (TLS or SSL, or "https://" address).
+
+
+## Read-write access
+
+To both read a calendar and help maintain its content,
+you need to setup a **CalDAV** profile:
+
+ 1. Open calendaring client, and add new account profile of type "CalDAV".
+ 2. Server address: **[[!template id=eventhost]]:8443**
+ 3. Username and password: Either personal or calendar-group account credentials.
+
+If above fails, or if you want to specifically pick a single calender,
+use this alternative approach:
+
+ 1. Copy address of relevant calendar from web page
+    **https://[[!template id=eventhost]]:8443/calendars/users/USERNAME/**  
+    (replace USERNAME with either personal or calendar-group account name)
+ 2. Open calendaring client, and add new account profile of type "CalDAV".
+ 3. Paste the calendar address as server address.
-- 
cgit v1.2.3