Admin: ch10: Write help chapter

1 files changed, 34 insertions, 3 deletions

diff --git a/src/admin/10_help.xml b/src/admin/10_help.xml
index e90bd4a..50a1578 100644
--- a/src/admin/10_help.xml
+++ b/src/admin/10_help.xml
@@ -1,9 +1,40 @@
 <?xml version="1.0" encoding="utf-8"?>
 <chapter label="10" id="help">
     <title>If You Need Help</title>
-    <para></para>
+    <highlights><para>If you experience an issue that you cannot solve by reading the Adélie Linux documentation, there are a large variety of avenues you may persue to ask the community for help.</para></highlights>
     <section>
-        <title></title>
-        <para></para>
+        <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 to systems administrators:</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 for 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-pkg.lists.adelielinux.org/">Adélie Packaging</ulink></para>
+                <para>This list is for requesting new packages, and sending patches to fix issues in existing packages.</para>
+                <para>Subscribe by sending electronic mail to adelie-pkg-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-pkg@lists.adelielinux.org/" /></para>
+            </listitem>
+            <listitem>
+                <para><ulink url="https://lists.adelielinux.org/postorius/lists/adelie-devel.lists.adelielinux.org/">Adélie Development</ulink></para>
+                <para>This list is for the discussion of development of the Adélie Linux distribution in general.</para>
+                <para>Subscribe by sending electronic mail to adelie-devel-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-devel@lists.adelielinux.org/" /></para>
+            </listitem>
+        </itemizedlist>
+    </section>
+    <section>
+        <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>
+        <title>Other avenues of support</title>
+        <para>If you have found an issue with a package (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 recommend to use the mailing lists instead.</para>
     </section>
 </chapter>