diff --git a/hashtagrules.txt b/hashtagrules.txt
index 211b2545..8e80a15c 100644
--- a/hashtagrules.txt
+++ b/hashtagrules.txt
@@ -5,6 +5,21 @@ As news arrives via RSS or Atom feeds it can be processed to add or remove hasht
 
 On the newswire edit screen, available to moderators, you can define the news processing rules. There is one rule per line.
 
+Syntax
+------
+
+if [conditions] then [action]
+
+Logical Operators
+-----------------
+
+The following operators are available:
+
+    not, and, or, xor, contains
+
+Examples
+--------
+
 A simple example is:
 
     if moderated and not #oxfordimc then block
@@ -13,7 +28,7 @@ For moderated feeds this will only allow items through if they have the #oxfordi
 
 If you want to add hashtags an example is:
 
-    if contains "garden" then add #gardening
+    if contains "garden" or contains "lawn" then add #gardening
 
 So if incoming news contains the word "garden" either in its title or description then it will automatically be assigned the hashtag #gardening. You can also add hashtags based upon other hashtags.