Docs patch for bug 87795: You now get an email with a URL containing a random…

docs/xml/using.xml

@@ -26,39 +26,80 @@
 
     <orderedlist>
       <listitem>
-        <para>Click the 
-        <quote>Open a new Bugzilla account</quote>
+        <para>
+          On the home page <filename>index.cgi</filename>, click the
+          <quote>Open a new Bugzilla account</quote> link, or the
+          <quote>New Account</quote> link available in the footer of pages.
+          Now enter your email address, then click the <quote>Send</quote>
+          button.
+        </para>
 
-        link, enter your email address and, optionally, your name in the
-        spaces provided, then click 
-        <quote>Create Account</quote>
+        <note>
+          <para>
+            If none of these links is available, this means that the
+            administrator of the installation has disabled self-registration.
+            This means that only an administrator can create accounts
+            for other users. One reason could be that this installation is
+            private.
+          </para>
+        </note>
 
-        .</para>
+        <note>
+          <para>
+            Also, if only some users are allowed to create an account on
+            the installation, you may see these links but your registration
+            may fail if your email address doesn't match the ones accepted
+            by the installation. This is another way to restrict who can
+            access and edit bugs in this installation.
+          </para>
+        </note>
       </listitem>
 
       <listitem>
-        <para>Within moments, you should receive an email to the address
-        you provided, which contains your login name (generally the
-        same as the email address), and a password. 
-        This password is randomly generated, but can be
-        changed to something more memorable.</para>
+        <para>
+          Within moments, and if your registration is accepted, you should
+          receive an email to the address you provided, which contains your
+          login name (generally the same as the email address), and two URLs
+          with a token (a random string generated by the installation) to
+          confirm, respectively cancel, your registration. This is a way to
+          prevent users from abusing the generation of user accounts, for
+          instance by entering inexistent email addresses, or email addresses
+          which do not belong to them.
+        </para>
       </listitem>
 
       <listitem>
-        <para>Click the 
-        <quote>Log In</quote>
-        link in the footer at the bottom of the page in your browser,
-        enter your email address and password into the spaces provided, and
-        click 
-        <quote>Login</quote>.
+        <para>
+          By default, you have 3 days to confirm your registration. Past this
+          timeframe, the token is invalidated and the registration is
+          automatically cancelled. You can also cancel this registration sooner
+          by using the appropriate URL in the email you got.
         </para>
+      </listitem>
 
+      <listitem>
+        <para>
+          If you confirm your registration, Bugzilla will ask you your real name
+          (optional, but recommended) and your password, which must be between
+          3 and 16 characters long.
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+          Now all you need to do is to click the <quote>Log In</quote>
+          link in the footer at the bottom of the page in your browser,
+          enter your email address and password you just chose into the
+          login form, and click the <quote>Log in</quote> button.
+        </para>
       </listitem>
     </orderedlist>
 
-    <para>You are now logged in. Bugzilla uses cookies to remember you are
+    <para>
+      You are now logged in. Bugzilla uses cookies to remember you are
       logged in so, unless you have cookies disabled or your IP address changes,
-    you should not have to log in again.</para>
+      you should not have to log in again during your session.
+    </para>
   </section>
 
   <section id="bug_page">