Easy Onboarding: introduction

inbox/user-invite.xml

@@ -37,13 +37,32 @@
   </revision>
 </header>
 <section1 topic='Introduction' anchor='intro'>
-  <p>Romeo is an active XMPP IM (Instant Messaging) user. He convinces Juliet
-    (who may not have an XMPP account yet) to install a client but she may
-    still need to choose a XMPP server and create an account.
-    This specification defines two ways to simplify this process for Juliet:</p>
+  <p>Romeo is an active XMPP IM (Instant Messaging) user or the operator of
+    an XMPP server. He convinces Juliet (who may not have an XMPP account yet)
+    to install a client but she may still need to choose an XMPP server,
+    create an account, and add Romeo as a contact.
+    This specification defines two ways for Romeo to simplify this process for Juliet:</p>
   <section2 topic='User Invitation'>
+    <p>If Romeo is an XMPP user, he can create an out-of-band link (URI)
+      which allows Juliet to:</p>
+    <ol>
+      <li>Download an XMPP client (if needed).</li>
+      <li>Optionally register an account with Romeo's server (if permitted by
+	the server rules), or with a public server.</li>
+      <li>Establish a mutual presence subscription between Romeo and Juliet.</li>
+    </ol>
+    <p>The process is designed to automatically skip steps that Juliet already
+      completed, to make the overall experience as smooth as possible.</p>
   </section2>
   <section2 topic='Account Creation'>
+    <p>If Romeo is an administrator of an XMPP server, he can create an
+      out-of-band link (URI) which allows Juliet to:</p>
+    <ol>
+      <li>Download an XMPP client (if needed).</li>
+      <li>Register an account on Romeo's server with a user name defined by
+	Romeo and a password not known to Romeo.</li>
+      <li>Establish a mutual presence subscription between Romeo and Juliet.</li>
+    </ol>
   </section2>
 </section1>
 <section1 topic='Requirements' anchor='reqs'>