[install-guide/F21-rewrite] Added intro to troubleshooting

pbokoc pbokoc at fedoraproject.org
Sat Sep 13 19:13:12 UTC 2014


commit 8b7c66b17d7084c47ac48c5b2e9acb4474f6cad6
Author: Petr Bokoc <pbokoc at redhat.com>
Date:   Sat Sep 13 19:34:42 2014 +0200

    Added intro to troubleshooting

 en-US/Troubleshooting.xml |   35 ++++++++++++++++++++++++++++++++++-
 1 files changed, 34 insertions(+), 1 deletions(-)
---
diff --git a/en-US/Troubleshooting.xml b/en-US/Troubleshooting.xml
index 0bdc31f..060adab 100644
--- a/en-US/Troubleshooting.xml
+++ b/en-US/Troubleshooting.xml
@@ -13,7 +13,40 @@
     <section id="sect-troubleshooting-getting-help">
         <title>Getting Help</title>
         <para>
-            text about ask.fedora.com, stackexchange, phoronix etc.
+            There are many places on the internet which can help you when you encounter a problem not described in this chapter: discussion boards, blogs, IRC, and more. Some of the more popular places where you can find help include:
+        </para>
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <ulink url="https://ask.fedoraproject.org/en/questions/">Ask Fedora</ulink> - Fedora's knowledge base, available in multiple languages
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                   The #fedora IRC channel on <ulink url="http://freenode.net/">FreeNode</ulink> - one of the main IRC channels used by Fedora users, English only
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                   <ulink url="http://unix.stackexchange.com/">Stack Exchange</ulink> - an English language Q&amp;A board, not specific to Fedora
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                   <ulink url="http://www.phoronix.com/forums/">Phoronix Forums</ulink> - an English language forum, not specific to Fedora
+                </para>
+            </listitem>
+        </itemizedlist>
+        <note>
+            <para>
+                The above list is by no means complete - you can find help in many other places as well.
+            </para>
+        </note>
+        <para>
+            Before you open a new discussion or ask anyone for help on IRC, you should always do some research on your own. If you are encountering an issue, there is usually a good chance that someone else ran into the same problem before you and published a solution somewhere. Opening a discussion about something already explained elsewhere, or asking a common question which has been answered many times before, is not likely to result in a friendly, constructive response.
+        </para>
+        <para>
+            When troubleshooting issues related to the installation, you might be asked to provide log files. The sections below explains which log files are generated during the installation and how to obtain them.
         </para>
 
         <section id="sect-troubleshooting-log-files">


More information about the docs-commits mailing list