# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1257707119 -3600
# Node ID 27922520e51f07b289abe18b66537c7481556868
# Parent  8212216604482106f77dc6d942c6b833ce600f38
Updated the help for the macro.

diff -r 821221660448 -r 27922520e51f pages/HelpOnEventAggregator
--- a/pages/HelpOnEventAggregator	Sun Nov 08 02:49:26 2009 +0100
+++ b/pages/HelpOnEventAggregator	Sun Nov 08 20:05:19 2009 +0100
@@ -9,11 +9,9 @@
 
 == Creating Events ==
 
-Before creating any events, create a category for those events. You can do this by filling out and submitting this form:
+The easiest way to create an event is to click on a day number in a calendar. If you do not have a calendar set up, take a look at the instructions for [[#PreparingACalendar|preparing]] and [[#ShowingEventCalendars|showing]] calendars first.
 
-<<NewPage(CategoryTemplate,Add a new category,,Category%s)>>
-
-Each event must be created on a new page belonging to the appropriate event category. The following action can be used to create a new event page (using !EventAggregatorNewEvent):
+Each event must be created on a new page belonging to the appropriate event category. The following action can be used to create a new event page (using !EventAggregatorNewEvent) without looking at a calendar:
 
 (!) <<Action(EventAggregatorNewEvent,Add an event)>>
 
@@ -56,6 +54,16 @@
  Topics:: Python, <<Verbatim(EuroPython)>>, Zope
 }}}
 
+<<Anchor(PreparingACalendar)>>
+== Preparing a Calendar ==
+
+Before trying to show a calendar or trying to create any events, first decide on a category for your events. You can create a new category for this purpose by filling out and submitting this form:
+
+<<NewPage(CategoryTemplate,Add a new category,,Category%s)>>
+
+It is not strictly necessary to have a dedicated category for events, but having such categories can make event management easier by preventing event pages getting mixed up with other kinds of pages. And since pages can belong to more than one category, you can still assign event pages to other categories and yet isolate the event pages via their own category when you need to.
+
+<<Anchor(ShowingEventCalendars)>>
 == Showing Event Calendars ==
 
 To show a calendar, use the !EventAggregator macro with a list of event categories. For example:
@@ -158,9 +166,9 @@
 
 To define your own topic colours, edit the `event-aggregator.css` file which is provided with the !EventAggregator distribution, and then reinstall that file for each of the Wiki themes of interest. Topics involved in event colouring should be mutually exclusive: more than one such topic should not be specified for any given event.
 
-=== Note ===
+=== The Default View and Switching Views ===
 
-The `calendar` value causes the default calendar view to be employed.
+The `calendar` value for the `mode` parameter causes the default calendar view to be employed, but you can switch the view - effectively changing the `mode` - using the links provided below the view produced by this macro.
 
 == See Also ==