From d8610080d2f980cf7181b7050ae17f4f37bc6922 Mon Sep 17 00:00:00 2001
From: Michael Stack <stack@apache.org>
Date: Sun, 22 Jan 2012 22:25:50 +0000
Subject: [PATCH] Edit of the mailing list/search archive section

git-svn-id: https://svn.apache.org/repos/asf/hbase/trunk@1234636 13f79535-47bb-0310-9956-ffa450edef68
---
 src/docbkx/preface.xml         |  2 +-
 src/docbkx/troubleshooting.xml | 20 +++++++++++++-------
 2 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/src/docbkx/preface.xml b/src/docbkx/preface.xml
index 10fa7559bc7..4a78a0fd6a9 100644
--- a/src/docbkx/preface.xml
+++ b/src/docbkx/preface.xml
@@ -49,7 +49,7 @@
           Distributed Computing, then you are in for
           some interesting times.  First off, distributed systems are
           hard; making a distributed system hum requires a disparate
-          skillset that needs span systems (hardware and software) and
+          skillset that spans systems (hardware and software) and
           networking.  Your cluster' operation can hiccup because of any
           of a myriad set of reasons from bugs in HBase itself through misconfigurations
           -- misconfiguration of HBase but also operating system misconfigurations --
diff --git a/src/docbkx/troubleshooting.xml b/src/docbkx/troubleshooting.xml
index fe971b902fb..d3fe149d3c1 100644
--- a/src/docbkx/troubleshooting.xml
+++ b/src/docbkx/troubleshooting.xml
@@ -198,17 +198,23 @@ export HBASE_OPTS="-XX:NewSize=64m -XX:MaxNewSize=64m &lt;cms options from above
     </section>
     <section xml:id="trouble.resources">
       <title>Resources</title>
-      <section xml:id="trouble.resources.lists">
-        <title>Dist-Lists</title>
-        <para>Sign up for the <link xlink:href="http://hbase.apache.org/mail-lists.html">HBase Dist-Lists</link> and post a question.  'Dev' is aimed at the
-        community of developers actually building HBase and for features currently under development, and 'User' for generally used for questions on released
-        versions of HBase.
-        </para>
-      </section>
       <section xml:id="trouble.resources.searchhadoop">
         <title>search-hadoop.com</title>
         <para>
         <link xlink:href="http://search-hadoop.com">search-hadoop.com</link> indexes all the mailing lists and is great for historical searches.  
+        Search here first when you have an issue as its more than likely someone has already had your problem.
+        </para>
+      </section>
+      <section xml:id="trouble.resources.lists">
+        <title>Mailing Lists</title>
+        <para>Ask a question on the <link xlink:href="http://hbase.apache.org/mail-lists.html">HBase mailing lists</link>.
+        The 'dev' mailing list is aimed at the community of developers actually building HBase and for features currently under development, and 'user'
+        is generally used for questions on released versions of HBase.  Before going to the mailing list, make sure your
+        question has not already been answered by searching the mailing list archives first.  Use
+        <xref linkend="trouble.resources.searchhadoop" />.
+        Take some time crafting your question<footnote><para>See <link xlink="http://www.mikeash.com/getting_answers.html">Getting Answers</link></para></footnote>; a quality question that includes all context and 
+        exhibits evidence the author has tried to find answers in the manual and out on lists
+        is more likely to get a prompt response.
         </para>
       </section>
       <section xml:id="trouble.resources.irc">