Update self registration.

Documentation/UseCase.rst

@@ -37,8 +37,10 @@
 Use Case
 ========
 
- * Create the request pages and tt-content records.
- * Copy the JSON form code to a new form (open Form in JSON mode).
+To install the following use cases, please:
+
+* Create the page and tt-content records.
+* Copy the JSON form code to a new empty form (open Form in JSON mode).
 
 
 .. _`self-registration`:
@@ -51,21 +53,21 @@ Concept:
 * Form 'Request password reset link'
 
   * Input: email address.
-  * Send a mail with a URL (incl. a token) which is time limited.
+  * Send a mail to the given email address with a password reset URL (incl. a token) which is time limited.
 
-    * Only send mail if the mail address is known.
+    * Only send mail if the mail address is known!
     * If email is not found, the user should not be noticed.
-    * Create a new Person.auth token.
-    * Set Person.authExpired = NOW + ? days.
+    * Create a new ``Person.auth`` token.
+    * Set ``Person.authExpired = NOW + ? days``.
 
-* Under the URL a form 'Set password' opens.
+* When the user opens the URL, the form 'Set password' is shown.
 
-  * The user types in his new password.
+  * The user types in the new password.
   * On Save:
 
     * If the FE account does not exist, it will be created.
     * Set the FE user password.
-    * Clear Person.authExpired
+    * Clear ``Person.authExpired``.
 
 Request password reset link
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -73,15 +75,17 @@ Request password reset link
 Table: Person
 """""""""""""
 
-CREATE TABLE `Person` (
-  `id` int(11) UNSIGNED NOT NULL,
-  `lastName` varchar(64) NOT NULL DEFAULT '',
-  `firstName` varchar(64) NOT NULL DEFAULT '',
-  `email` varchar(128) NOT NULL,
-  `account` varchar(128) NOT NULL,
-  `auth`  varchar(32) NOT NULL,
-  `authExpire` datetime NOT NULL,
-) ENGINE=InnoDB DEFAULT CHARSET=utf8 PACK_KEYS=1;
+Person::
+
+    CREATE TABLE `Person` (
+      `id` int(11) UNSIGNED NOT NULL,
+      `lastName` varchar(64) NOT NULL DEFAULT '',
+      `firstName` varchar(64) NOT NULL DEFAULT '',
+      `email` varchar(128) NOT NULL,
+      `account` varchar(128) NOT NULL,
+      `auth`  varchar(32) NOT NULL,
+      `authExpire` datetime NOT NULL,
+    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 PACK_KEYS=1;
 
 Page: reset
 """""""""""