Improved explanations

lang/en/help/enrolmentkey.html

@@ -5,22 +5,47 @@
 
 <P>If you leave this blank, then anyone who has created 
    a Moodle username on this site will be able to enrol
-   in your course.
+   in your course simply by going in to it.
 
 <P>If you put something here, then students who are trying 
    to get in for the FIRST TIME ONLY will be asked to supply 
-   this word or phrase.  The guest account can also get in
-   to the course using the enrolment key - but it will be asked
-   for the key EVERY TIME a guest logs in the course. (This occurs
-   even if you have specified 'no guests are allowed')
+   this word or phrase.
 
 <P>The idea is that you will supply the key to authorised 
    people using another means like private email, snail mail,
    on the phone or even verbally in a face to face class.
 
 <P>If this password "gets out" and you have unwanted people 
    enrolling, you can unenrol them (see their user profile page)
-   and change this key.  Any legitimate students who have already enrolled will
-   not be affected, but the unwanted people won't be able 
-   to get back in.
+   and change this key.  Any legitimate students who have already 
+   enrolled will not be affected, but the unwanted people won't be 
+   able to get back in.
+
+<P>Note that if you have an enrolment key set, then the guest account 
+   can also get in to the course using the key - but it will be asked
+   for the key EVERY TIME a guest logs in the course. (This occurs
+   EVEN if you have specified 'No guests are allowed')
+
+<P>This diagram explains how it works:
 
+<table border="1" align="center" cellpadding="5">
+  <tr>
+    <th nowrap width="8">&nbsp;</th>
+    <th nowrap width="84">Enrolment key</th>
+    <th nowrap width="79">No enrolment key</th>
+  </tr>
+  <tr>
+    <th nowrap>Guest access</th>
+    <td nowrap><p>Students need key</p>
+      <p>Guests get in free</p></td>
+    <td nowrap><p>Students get in free</p>
+      <p>Guests get in free</p></td>
+  </tr>
+  <tr>
+    <th nowrap>No guest access</th>
+    <td nowrap><p>Students need key</p>
+      <p>Guests need key</p></td>
+    <td nowrap><p>Students get in free</p>
+      <p>No guests allowed</p></td>
+  </tr>
+</table>

lang/en/help/guestaccess.html

@@ -1,18 +1,40 @@
-<P ALIGN=CENTER><B>Guest Access</B></P>
-
-<P>You have the choice of allowing "guests" into your course
-
-<P>People can log in as guests using the "Login as a guest" button
-   on the login screen.
-
-<P>Guests have "read-only" access - meaning they can't leave 
-   any posts or otherwise mess up the course for real students.
-
-<P>This can be handy when you want to let a colleague in to 
-   look around at your work, or to let students see a course before 
-   they have decided to enrol.
-
-<P>If you have Guest access turned off, but have an enrolment key 
-   defined, then guests can still get in provided they can provide 
-   the right enrolment key.
-
+<P ALIGN=CENTER><B>Guest Access</B></P>
+
+<P>You have the choice of allowing "guests" into your course
+
+<P>People can log in as guests using the "Login as a guest" button
+   on the login screen.
+
+<P>Guests have "read-only" access - meaning they can't leave 
+   any posts or otherwise mess up the course for real students.
+
+<P>This can be handy when you want to let a colleague in to 
+   look around at your work, or to let students see a course before 
+   they have decided to enrol.
+
+<P>If you have Guest access turned off, but have an enrolment key 
+   defined, then guests can still get in provided they can provide 
+   the right enrolment key.
+
+<P>This diagram might help make the behaviour clear: 
+<table border="1" align="center" cellpadding="5">
+  <tr>
+    <th nowrap width="8">&nbsp;</th>
+    <th nowrap width="84">Enrolment key</th>
+    <th nowrap width="79">No enrolment key</th>
+  </tr>
+  <tr>
+    <th nowrap>Guest access</th>
+    <td nowrap><p>Students need key</p>
+      <p>Guests get in free</p></td>
+    <td nowrap><p>Students get in free</p>
+      <p>Guests get in free</p></td>
+  </tr>
+  <tr>
+    <th nowrap>No guest access</th>
+    <td nowrap><p>Students need key</p>
+      <p>Guests need key</p></td>
+    <td nowrap><p>Students get in free</p>
+      <p>No guests allowed</p></td>
+  </tr>
+</table>