install: Write appendix B

1 files changed, 35 insertions, 3 deletions

diff --git a/src/install/b_help.xml b/src/install/b_help.xml
index 0ead88f..5ac630c 100644
--- a/src/install/b_help.xml
+++ b/src/install/b_help.xml
@@ -1,8 +1,40 @@
 <?xml version="1.0" encoding="utf-8"?>
 <appendix label="b" id="help">
     <title>If You Need Help</title>
-    <section>
-        <title/>
-        <para/>
+    <highlights><para>If you experience an issue that you cannot solve by reading the Adélie Linux documentation, there are a variety of avenues available to you to ask the community for help.</para></highlights>
+    <section id="mailing_lists">
+        <title>Mailing Lists</title>
+        <para>The Adélie Linux mailing lists are a great way to obtain answers to any number of issues.  Helpful members of the community, along with most of the Adélie Linux development team, are always monitoring the mailing lists and are ready to help you with your issue.  There are three main mailing lists that would be of interest for installation issues:</para>
+        <itemizedlist>
+            <listitem>
+                <para><ulink url="https://lists.adelielinux.org/postorius/lists/adelie-users.lists.adelielinux.org/">Adélie Users</ulink></para>
+                <para>This list is for the discussion and support of general issues in day-to-day use of the Adélie Linux system.</para>
+                <para>Subscribe by sending electronic mail to adelie-users-join@lists.adelielinux.org with "subscribe" in the subject.</para>
+                <para>View online archives by connecting a Web browser to: <ulink url="https://lists.adelielinux.org/hyperkitty/list/adelie-users@lists.adelielinux.org/" /></para>
+            </listitem>
+            <listitem>
+                <para><ulink url="https://lists.adelielinux.org/postorius/lists/adelie-ports.lists.adelielinux.org/">Adélie Ports</ulink></para>
+                <para>This list is for the discussion and support of issues using Adélie Linux on tier 2 and 3 architectures, such as 32-bit ARM.</para>
+                <para>Subscribe by sending electronic mail to adelie-ports-join@lists.adelielinux.org with "subscribe" in the subject.</para>
+                <para>View online archives by connecting a Web browser to: <ulink url="https://lists.adelielinux.org/hyperkitty/list/adelie-ports@lists.adelielinux.org/" /></para>
+            </listitem>
+            <listitem>
+                <para><ulink url="https://lists.adelielinux.org/postorius/lists/horizon.lists.adelielinux.org/">Horizon</ulink></para>
+                <para>This list is for the specific discussion of development of the Horizon system.  This list is primarily used for discussing patches or feature requests; normal installation issues should be sent to adelie-users.</para>
+                <para>Subscribe by sending electronic mail to horizon-join@lists.adelielinux.org with "subscribe" in the subject.</para>
+                <para>View online archives by connecting a Web browser to: <ulink url="https://lists.adelielinux.org/hyperkitty/list/horizon@lists.adelielinux.org/" /></para>
+            </listitem>
+        </itemizedlist>
+    </section>
+    <section id="chat">
+        <title>Community Chat</title>
+        <para>The Adélie Linux community has a dedicated online chat system for asking quick questions about using the Adélie Linux system.  We welcome all of our users to our chat, and we look forward to seeing you!  Please note that detailed or complex issues may be referred to the mailing lists.</para>
+        <para>The chat system uses the Internet Relay Chat (IRC) protocol; to join the chat, you will need to use an IRC client.  Three popular clients are packaged in the Adélie Linux system: <package>Konversation</package> (the KDE IRC client), <package>Quassel</package> (a popular Qt IRC client), and <package>WeeChat</package> (a terminal-based IRC client).</para>
+        <para>To join our chat, connect to the Interlinked IRC network at irc.interlinked.me (TLS port 6697), and then join the #Adelie-Support channel.</para>
+    </section>
+    <section id="more_help">
+        <title>Other avenues of support</title>
+        <para>If you have found a reproducable issue in Horizon (a segmentation fault, crash, or hang/freeze), you may file an issue at <ulink url="https://bts.adelielinux.org/">the Adélie Linux issue tracker</ulink>.</para>
+        <para>The <ulink url="https://www.reddit.com/r/AdelieLinux/">Adélie Linux sub on Reddit</ulink> is sometimes used for asking for help, but it is highly recommended to use the mailing lists instead.</para>
     </section>
 </appendix>