User docs: Embed account type configuration instructions on First Run Wizard page.

The instructions per account are collapsed by default and expandable in clients that support ui: (like recent Yelp versions). This requires turning the <list> of account types on intro-first-run.page into <section>s as ui:expandable is not supported inside of <list> elements.

Embedding directly does not require users to follow "Click here for configuration instructions for this account" links anymore, that we get rid of "Click here to get to next step if you came from the First Run Wizard help page" sections at the bottom of each account type configuration page.

12 files changed, 177 insertions, 81 deletions

diff --git a/help/C/intro-first-run.page b/help/C/intro-first-run.page
index 5fe79d6069..1df68cfc72 100644
--- a/help/C/intro-first-run.page
+++ b/help/C/intro-first-run.page
@@ -42,28 +42,65 @@
    xmlns="http://www.w3.org/2001/XInclude"/>
  </section>
 </section>
+
 <section id="receiving">
 <title>Receiving Email</title>
 <p>First, choose the server type from the <gui>Server Type</gui> drop-down list.</p>
 <p>If you are unsure about the type of server to choose, ask your system administrator or Internet Service Provider.</p>
 
+<note style="tip"><p>Later on, if you want to change an account, or if you want to create another one, go to <guiseq><gui>Edit</gui><gui>Preferences</gui><gui>Mail Accounts</gui></guiseq>. Select the account you want to change, then click <gui style="button">Edit</gui>. Alternately, add a new account by clicking <gui style="button">Add</gui>.</p></note>
+
+<section id="server-type-imap+">
+<title>IMAP+</title>
+<p>Keeps the mail on the server so you can access your mail from multiple systems.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>IMAP+ receiving options</title>
+  <include href="mail-receiving-options-imap-plus.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-pop">
+<title>POP</title>
+<p>Downloads your email to your hard disk.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>POP receiving options</title>
+  <include href="mail-receiving-options-pop.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-usenet">
+<title>USENET News</title>
+<p>Connects to a news server and downloads a list of available news digests.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Usenet news receiving options</title>
+  <include href="mail-receiving-options-usenet-news.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
 
-<section id="common-server-types">
-<title>Common server types</title>
-<p>The most common available server types for normal users are:</p>
-<list>
-<item><p>None: If you do not plan to use Evolution for receiving email.</p><p>Continue <link xref="#sending">here</link> for configuration.</p></item>
-<item><p>IMAP+: Keeps the mail on the server so you can access your mail from multiple systems.</p><p>Continue <link xref="mail-receiving-options-imap-plus">here</link> for configuration.</p></item>
-<item><p>POP: Downloads your email to your hard disk.</p><p>Continue <link xref="mail-receiving-options-pop">here</link> for configuration.</p></item>
-<item><p>USENET News: Connects to a news server and downloads a list of available news digests.</p><p>Continue <link xref="mail-receiving-options-usenet-news">here</link> for configuration.</p></item>
-</list>
 </section>
 
-<section id="corporate-server-types">
-<title>Corporate server types</title>
-<p>Available server types for corporate users are:</p>
-<list>
-<item><p>Exchange EWS: For connecting to a Microsoft Exchange 2007/2010 or OpenChange server. Note that this is currently under development and will replace the <gui>Exchange MAPI</gui> account type in the future. It might not be available yet for your distribution.</p><p>Continue <link xref="mail-receiving-options-exchange-ews">here</link> for configuration.</p>
+<section id="server-type-exchange-ews">
+<title>Exchange EWS</title>
+<p>For connecting to a Microsoft Exchange 2007/2010 or OpenChange server. Note that this is currently under development and will replace the <gui>Exchange MAPI</gui> account type in the future. It might not be available yet for your distribution.</p>
 <note style="info package">
   <p>This requires having the <sys>evolution-ews</sys> package installed.</p>
   <if:choose>
@@ -72,9 +109,22 @@
     </if:when>
   </if:choose>
 </note>
-</item>
 
-<item><p>Exchange MAPI: For connecting to a Microsoft Exchange 2007/2010 or OpenChange server.</p><p>Continue <link xref="mail-receiving-options-exchange-mapi">here</link> for configuration.</p>
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Exchange Web Services receiving options</title>
+  <include href="mail-receiving-options-exchange-ews.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-exchange-mapi">
+<title>Exchange MAPI</title>
+<p>For connecting to a Microsoft Exchange 2007/2010 or OpenChange server.</p>
 <note style="info package">
   <p>This requires having the <sys>evolution-mapi</sys> package installed.</p>
   <if:choose>
@@ -83,30 +133,102 @@
     </if:when>
   </if:choose>
 </note>
-</item>
-</list>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Exchange MAPI receiving options</title>
+  <include href="mail-receiving-options-exchange-mapi.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
 </section>
 
-<section id="local-account-server-types">
-<title>Local account server types</title>
-<p>Available local account server types for advanced users are:</p>
-<list>
-<item><p>Local delivery: If you want to move email from the spool (the location where mail waits for delivery) and store it in your home directory. You need to provide the path to the mail spool you want to use. If you want to leave email in your system's spool files, choose the <gui>Standard Unix Mbox Spool</gui> option instead.</p><p>Continue <link xref="mail-receiving-options-local-delivery">here</link> for configuration.</p></item>
+<section id="server-type-local-delivery">
+<title>Local delivery</title>
+<p>Local delivery: If you want to move email from the spool (the location where mail waits for delivery) and store it in your home directory. You need to provide the path to the mail spool you want to use. If you want to leave email in your system's spool files, choose the <gui>Standard Unix Mbox Spool</gui> option instead.</p>
 
-<item><p>MH-Format Mail Directories: For downloading email using MH or another MH-style application.</p>
-<p>Continue <link xref="mail-receiving-options-mh-format-directories">here</link> for configuration.</p></item>
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Local delivery receiving options</title>
+  <include href="mail-receiving-options-local-delivery.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
 
-<item><p>Maildir-Format Mail Directories: For downloading your email using Qmail or another Maildir-style application.</p>
-<p>Continue <link xref="mail-receiving-options-maildir-format-directories">here</link> for configuration.</p></item>
+</section>
 
-<item><p>Standard Unix mbox spool file: For reading and storing email in the mail spool file on your local system.</p>
-<p>Continue <link xref="mail-receiving-options-unix-mbox-spool-file">here</link> for configuration.</p></item>
+<section id="server-type-mh-format-directories">
+<title>MH-Format Mail Directories</title>
+<p>For downloading email using MH or another MH-style application.</p>
 
-<item><p>Standard Unix mbox spool directory: For reading and storing email in the mail spool directory on your local system.</p>
-<p>Continue <link xref="mail-receiving-options-unix-mbox-spool-directory">here</link> for configuration.</p></item>
-</list>
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>MH-format mail directories receiving options</title>
+  <include href="mail-receiving-options-mh-format-directories.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-maildir-format-directories">
+<title>Maildir-Format Mail Directories</title>
+<p>Maildir-Format Mail Directories: For downloading your email using Qmail or another Maildir-style application.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Maildir-format mail directories receiving options</title>
+  <include href="mail-receiving-options-maildir-format-directories.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
 
-<note style="tip"><p>Later on, if you want to change an account, or if you want to create another one, go to <guiseq><gui>Edit</gui><gui>Preferences</gui><gui>Mail Accounts</gui></guiseq>. Select the account you want to change, then click <gui style="button">Edit</gui>. Alternately, add a new account by clicking <gui style="button">Add</gui>.</p></note>
+</section>
+
+<section id="server-type-unix-mbox-spool-file">
+<title>Standard Unix mbox spool file</title>
+<p>Standard Unix mbox spool file: For reading and storing email in the mail spool file on your local system.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Standard Unix mbox spool file receiving options</title>
+  <include href="mail-receiving-options-unix-mbox-spool-file.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-unix-mbox-spool-directory">
+<title>Standard Unix mbox spool directory</title>
+<p>Standard Unix mbox spool directory: For reading and storing email in the mail spool directory on your local system.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>Standard Unix mbox spool directory receiving options</title>
+  <include href="mail-receiving-options-unix-mbox-spool-directory.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:section)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type-none">
+<title>None</title>
+<p>If you do not plan to use Evolution for receiving email.</p>
 </section>
 
 </section>
@@ -114,10 +236,28 @@
 <section id="sending"> <!-- Do not rename, we link to it from the subpages -->
 <title>Sending mail</title>
 <p>Available server types are:</p>
-<list>
-<item><p>SMTP: Sends mail using an outbound mail server. This is the most common choice for sending mail.</p><p>Continue <link xref="mail-sending-options-smtp">here</link> for configuration.</p></item>
-<item><p>Sendmail: Uses the <app>Sendmail</app> application to send mail from your system. It is not easy to configure, so you should select this option only if you know how to set up a Sendmail service.</p></item>
-</list>
+
+<section id="server-type-smtp">
+<title>SMTP</title>
+<p>Sends mail using an outbound mail server. This is the most common choice for sending mail.</p>
+
+ <section id="restore-howto" ui:expanded="false">
+  <info>
+    <title type="ui:collapsed">Show how to configure this account type</title>
+  </info>
+  <title>SMTP sending options</title>
+  <include href="mail-sending-options-smtp.page"
+   xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:list)"
+   xmlns="http://www.w3.org/2001/XInclude"/>
+ </section>
+
+</section>
+
+<section id="server-type=sendmail">
+<title>Sendmail</title>
+<p>Uses the <app>Sendmail</app> application to send mail from your system. It is not easy to configure, so you should select this option only if you know how to set up a Sendmail service.</p>
+</section>
+
 </section>
 
 <section id="account-information">
diff --git a/help/C/mail-receiving-options-exchange-ews.page b/help/C/mail-receiving-options-exchange-ews.page
index b79efc3860..e67690d12d 100644
--- a/help/C/mail-receiving-options-exchange-ews.page
+++ b/help/C/mail-receiving-options-exchange-ews.page
@@ -47,9 +47,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
-
 </page>
diff --git a/help/C/mail-receiving-options-exchange-mapi.page b/help/C/mail-receiving-options-exchange-mapi.page
index 90a3bada04..6c46b3c6aa 100644
--- a/help/C/mail-receiving-options-exchange-mapi.page
+++ b/help/C/mail-receiving-options-exchange-mapi.page
@@ -47,8 +47,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-imap-plus.page b/help/C/mail-receiving-options-imap-plus.page
index 73cd223431..9ff70c0a77 100644
--- a/help/C/mail-receiving-options-imap-plus.page
+++ b/help/C/mail-receiving-options-imap-plus.page
@@ -53,8 +53,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-local-delivery.page b/help/C/mail-receiving-options-local-delivery.page
index d64f268ef4..bbe1476f83 100644
--- a/help/C/mail-receiving-options-local-delivery.page
+++ b/help/C/mail-receiving-options-local-delivery.page
@@ -41,8 +41,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-maildir-format-directories.page b/help/C/mail-receiving-options-maildir-format-directories.page
index 75cf4adc56..e78fb26b17 100644
--- a/help/C/mail-receiving-options-maildir-format-directories.page
+++ b/help/C/mail-receiving-options-maildir-format-directories.page
@@ -42,8 +42,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-mh-format-directories.page b/help/C/mail-receiving-options-mh-format-directories.page
index fd109afdf7..11ff2b18c1 100644
--- a/help/C/mail-receiving-options-mh-format-directories.page
+++ b/help/C/mail-receiving-options-mh-format-directories.page
@@ -41,8 +41,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-pop.page b/help/C/mail-receiving-options-pop.page
index 26a262d0b1..11a903cfd2 100644
--- a/help/C/mail-receiving-options-pop.page
+++ b/help/C/mail-receiving-options-pop.page
@@ -54,8 +54,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-unix-mbox-spool-directory.page b/help/C/mail-receiving-options-unix-mbox-spool-directory.page
index 310ccaad0f..86912e41f1 100644
--- a/help/C/mail-receiving-options-unix-mbox-spool-directory.page
+++ b/help/C/mail-receiving-options-unix-mbox-spool-directory.page
@@ -41,8 +41,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-unix-mbox-spool-file.page b/help/C/mail-receiving-options-unix-mbox-spool-file.page
index d32b71e100..d1a758a8f4 100644
--- a/help/C/mail-receiving-options-unix-mbox-spool-file.page
+++ b/help/C/mail-receiving-options-unix-mbox-spool-file.page
@@ -42,8 +42,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-receiving-options-usenet-news.page b/help/C/mail-receiving-options-usenet-news.page
index 2f433d209a..8f1d7a1b51 100644
--- a/help/C/mail-receiving-options-usenet-news.page
+++ b/help/C/mail-receiving-options-usenet-news.page
@@ -52,8 +52,4 @@
 
 </section>
 
-<section id="return-to-assistant-bottom-link">
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#sending">here</link> to continue with the next step.</p>
-</section>
 </page>
diff --git a/help/C/mail-sending-options-smtp.page b/help/C/mail-sending-options-smtp.page
index 55097cf732..da34213c49 100644
--- a/help/C/mail-sending-options-smtp.page
+++ b/help/C/mail-sending-options-smtp.page
@@ -38,7 +38,4 @@
 <item><p>Choose <gui>Use secure connection</gui> if you want to connect securely.</p></item>
 </list>
 
-<!-- TODO:XINCLUDE: Replace this "go back" workaround by using xinclude and ui:expanded in intro-first-run.page itself, so content is embedded there and expandable. See http://projectmallard.org/ui/1.0/ui_expanded.html and https://help.gnome.org/users/gnome-help/3.6/keyboard-shortcuts-set.html -->
-<p>If you came to this page from the first-run wizard help page, click <link xref="intro-first-run#account-information">here</link> to continue with the next step.</p>
-
 </page>