svn commit: r1234636 - in /hbase/trunk/src/docbkx: preface.xml troubleshooting.xml

[st...@apache.org]

Author: stack
Date: Sun Jan 22 22:25:50 2012
New Revision: 1234636

URL: http://svn.apache.org/viewvc?rev=1234636&view=rev
Log:
Edit of the mailing list/search archive section

Modified:
    hbase/trunk/src/docbkx/preface.xml
    hbase/trunk/src/docbkx/troubleshooting.xml

Modified: hbase/trunk/src/docbkx/preface.xml
URL: http://svn.apache.org/viewvc/hbase/trunk/src/docbkx/preface.xml?rev=1234636&r1=1234635&r2=1234636&view=diff
==============================================================================
--- hbase/trunk/src/docbkx/preface.xml (original)
+++ hbase/trunk/src/docbkx/preface.xml Sun Jan 22 22:25:50 2012
@@ -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 --

Modified: hbase/trunk/src/docbkx/troubleshooting.xml
URL: http://svn.apache.org/viewvc/hbase/trunk/src/docbkx/troubleshooting.xml?rev=1234636&r1=1234635&r2=1234636&view=diff
==============================================================================
--- hbase/trunk/src/docbkx/troubleshooting.xml (original)
+++ hbase/trunk/src/docbkx/troubleshooting.xml Sun Jan 22 22:25:50 2012
@@ -198,17 +198,23 @@ export HBASE_OPTS="-XX:NewSize=64m -XX:M
     </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">