From d33b8f3665b4f7d3eb9864d6dbd1c8d15b4e8c14 Mon Sep 17 00:00:00 2001
From: Andrew McMillan <debian@mcmillan.net.nz>
Date: Sun, 29 Oct 2006 19:35:07 +1300
Subject: [PATCH] Rewritten content to provide some useful help and overview
 for users.

---
 htdocs/index.php | 51 +++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 44 insertions(+), 7 deletions(-)

diff --git a/htdocs/index.php b/htdocs/index.php
index 06b0d661..568999e9 100644
--- a/htdocs/index.php
+++ b/htdocs/index.php
@@ -7,14 +7,51 @@ require_once("interactive-page.php");
 include("page-header.php");
 
   echo <<<EOBODY
-<h1>These are the admin pages...</h1>
-<p>You appear to be logged on as $session->username ($session->fullname)</p>
-<p>Useful links:
-<ul>
-<li><a href="/help.php">Help on configuring CalDAV clients with RSCDS</a></li>
-</ul>
-</p>
+<h1>Administration</h1>
+<p>You are logged on as $session->username ($session->fullname)</p>
 EOBODY;
+?>
+<h2>Administration Functions</h2>
+<p>The administration of this application should be fairly simple.  You can administer:</p>
+<ul>
+<li>Users (or Resources or Groups) and the relationships between them</li>
+<li>The types of relationships that are available</li>
+</ul>
+<p><i>There is no ability to view and / or maintain calendars or events from within this administrative interface.</i></p>
+<p>To do that you will need to use a CalDAV capable calendaring application such as Evolution, Sunbird, Thunderbird
+(with the Lightning extension) or Mulberry.</p>
 
+<h3>Users, Resources and Groups</h3>
+<p>These are the things which may have collections of calendar resources (i.e. calendars).</p>
+<p><a href="">Here is a list of users</a>.  You can click on any user to see the full detail
+for that person (or group or resource - but from now we'll just call them users).</p>
+<p>The primary differences between them are as follows:</p>
+<ul>
+<li>Users will probably have calendars, and are likely to also log on to the system.</li>
+<li>Resources do have calendars, but they will not usually log on.</li>
+<li>Groups provide an intermediate linking to minimise administration overhead.  They might not have calendars, and they will not usually log on.</li>
+</ul>
+
+<h3>Types of Relationships</h3>
+<p>These define the structure of the relationships between users.</p>
+<p>A manager might want to grant full access to their calendar to an assistant, for example, so
+there should be an "Is assisted by" relationship between the manager and the assistant.</p>
+<p>Relationships themselves are maintained on the User maintenance screen.</p>
+<p>It can also be useful to have several people having the same kind of access to a particular
+set of resources.  The "Is a member of group" relationship is used to link users to the group,
+and then the group is linked to each resource with the "Administers Resource" relationship.</p>
+<p>You can also define other relationship types beyond the basic ones just described.</p>
+
+<h2>Configuring Calendar Clients for RSCDS</h2>
+<p>The <a href="http://rscds.sourceforge.net/clients.php">RSCDS client setup page on sourceforge</a> have information on how
+to configure Evolution, Sunbird, Lightning and Mulberry to use remotely hosted calendars.</p>
+<p>The administrative interface has no facility for viewing or modifying calendar data.</p>
+
+<h2>Configuring RSCDS</h2>
+<p>If you can read this then things must be mostly working already.</p>
+<p>The <a href="http://rscds.sourceforge.net/installation.php">RSCDS installation page</a> on sourceforge has
+some further information on how to install and configure this application.</p>
+
+<?php
 include("page-footer.php");
 ?>
\ No newline at end of file