Expand guidance on SO and mailing lists, per discussion

2 files changed, 103 insertions, 6 deletions

diff --git a/community.md b/community.md
index 480d05a45..c4f83a5ea 100644
--- a/community.md
+++ b/community.md
@@ -9,10 +9,37 @@ navigation:
 
 <h2>Apache Spark Community</h2>
 
+<a name="have-questions"></a>
+<h3>Have Questions?</h3>
+
+<h4>StackOverflow</h4>
+
+For usage questions and help (e.g. how to use this Spark API), it is recommended you use the 
+StackOverflow tag <a href="http://stackoverflow.com/questions/tagged/apache-spark">`apache-spark`</a> 
+as it is an active forum for Spark users' questions and answers.
+
+Some quick tips when using StackOverflow:
+
+- Prior to asking submitting questions, please:
+  - Search StackOverflow's 
+  <a href="http://stackoverflow.com/questions/tagged/apache-spark">`apache-spark`</a> tag to see if 
+  your question has already been answered
+  - Search the nabble archive for
+  <a href="http://apache-spark-user-list.1001560.n3.nabble.com/">users@spark.apache.org</a> 
+- Please follow the StackOverflow <a href="http://stackoverflow.com/help/how-to-ask">code of conduct</a>  
+- Always use the `apache-spark` tag when asking questions
+- Please also use a secondary tag to specify components so subject matter experts can more easily find them.
+ Examples include: `pyspark`, `spark-dataframe`, `spark-streaming`, `spark-r`, `spark-mllib`, 
+  `spark-ml`, `spark-graphx`, `spark-graphframes`, `spark-tensorframes`, etc. 
+- Please do not cross-post between StackOverflow and the mailing lists
+- No jobs, sales, or solicitation is permitted on StackOverflow
+
 <a name="mailing-lists"></a>
-<h3>Mailing Lists</h3>
+<h4>Mailing Lists</h4>
+
+For broad, opinion based, ask for external resources, debug issues, bugs, contributing to the 
+project, and scenarios, it is recommended you use the user@spark.apache.org mailing list.
 
-<p>Get help using Spark or contribute to the project on our mailing lists:</p>
 <ul>
   <li>
     <a href="http://apache-spark-user-list.1001560.n3.nabble.com">user@spark.apache.org</a> is for usage questions, help, and announcements.
@@ -28,7 +55,22 @@ navigation:
   </li>
 </ul>
 
-<p>The StackOverflow tag <a href="http://stackoverflow.com/questions/tagged/apache-spark"><code>apache-spark</code></a> is an unofficial but active forum for Spark users' questions and answers.</p>
+Some quick tips when using email:
+
+- Prior to asking submitting questions, please:
+  - Search StackOverflow at <a href="http://stackoverflow.com/questions/tagged/apache-spark">`apache-spark`</a> 
+  to see if your question has already been answered
+  - Search the nabble archive for
+  <a href="http://apache-spark-user-list.1001560.n3.nabble.com/">users@spark.apache.org</a> 
+- Tagging the subject line of your email will help you get a faster response, e.g. 
+`[Spark SQL]: Does Spark SQL support LEFT SEMI JOIN?`
+- Tags may help identify a topic by:
+  - Component: Spark Core, Spark SQL, ML, MLlib, GraphFrames, GraphX, TensorFrames, etc
+  - Level: Beginner, Intermediate, Advanced
+  - Scenario: Debug, How-to
+- For error logs or long code examples, please use <a href="https://gist.github.com/">GitHub gist</a> 
+and include only a few lines of the pertinent code / log within the email.
+- No jobs, sales, or solicitation is permitted on the Apache Spark mailing lists.
 
 <a name="events"></a>
 <h3>Events and Meetups</h3>
diff --git a/site/community.html b/site/community.html
index 79ab192f1..fe4aa35bd 100644
--- a/site/community.html
+++ b/site/community.html
@@ -185,10 +185,42 @@
   <div class="col-md-9 col-md-pull-3">
     <h2>Apache Spark Community</h2>
 
+<p><a name="have-questions"></a></p>
+<h3>Have Questions?</h3>
+
+<h4>StackOverflow</h4>
+
+<p>For usage questions and help (e.g. how to use this Spark API), it is recommended you use the 
+StackOverflow tag <a href="http://stackoverflow.com/questions/tagged/apache-spark"><code>apache-spark</code></a> 
+as it is an active forum for Spark users&#8217; questions and answers.</p>
+
+<p>Some quick tips when using StackOverflow:</p>
+
+<ul>
+  <li>Prior to asking submitting questions, please:
+    <ul>
+      <li>Search StackOverflow&#8217;s 
+<a href="http://stackoverflow.com/questions/tagged/apache-spark"><code>apache-spark</code></a> tag to see if 
+your question has already been answered</li>
+      <li>Search the nabble archive for
+<a href="http://apache-spark-user-list.1001560.n3.nabble.com/">users@spark.apache.org</a></li>
+    </ul>
+  </li>
+  <li>Please follow the StackOverflow <a href="http://stackoverflow.com/help/how-to-ask">code of conduct</a></li>
+  <li>Always use the <code>apache-spark</code> tag when asking questions</li>
+  <li>Please also use a secondary tag to specify components so subject matter experts can more easily find them.
+ Examples include: <code>pyspark</code>, <code>spark-dataframe</code>, <code>spark-streaming</code>, <code>spark-r</code>, <code>spark-mllib</code>, 
+<code>spark-ml</code>, <code>spark-graphx</code>, <code>spark-graphframes</code>, <code>spark-tensorframes</code>, etc.</li>
+  <li>Please do not cross-post between StackOverflow and the mailing lists</li>
+  <li>No jobs, sales, or solicitation is permitted on StackOverflow</li>
+</ul>
+
 <p><a name="mailing-lists"></a></p>
-<h3>Mailing Lists</h3>
+<h4>Mailing Lists</h4>
+
+<p>For broad, opinion based, ask for external resources, debug issues, bugs, contributing to the 
+project, and scenarios, it is recommended you use the user@spark.apache.org mailing list.</p>
 
-<p>Get help using Spark or contribute to the project on our mailing lists:</p>
 <ul>
   <li>
     <a href="http://apache-spark-user-list.1001560.n3.nabble.com">user@spark.apache.org</a> is for usage questions, help, and announcements.
@@ -204,7 +236,30 @@
   </li>
 </ul>
 
-<p>The StackOverflow tag <a href="http://stackoverflow.com/questions/tagged/apache-spark"><code>apache-spark</code></a> is an unofficial but active forum for Spark users' questions and answers.</p>
+<p>Some quick tips when using email:</p>
+
+<ul>
+  <li>Prior to asking submitting questions, please:
+    <ul>
+      <li>Search StackOverflow at <a href="http://stackoverflow.com/questions/tagged/apache-spark"><code>apache-spark</code></a> 
+to see if your question has already been answered</li>
+      <li>Search the nabble archive for
+<a href="http://apache-spark-user-list.1001560.n3.nabble.com/">users@spark.apache.org</a></li>
+    </ul>
+  </li>
+  <li>Tagging the subject line of your email will help you get a faster response, e.g. 
+<code>[Spark SQL]: Does Spark SQL support LEFT SEMI JOIN?</code></li>
+  <li>Tags may help identify a topic by:
+    <ul>
+      <li>Component: Spark Core, Spark SQL, ML, MLlib, GraphFrames, GraphX, TensorFrames, etc</li>
+      <li>Level: Beginner, Intermediate, Advanced</li>
+      <li>Scenario: Debug, How-to</li>
+    </ul>
+  </li>
+  <li>For error logs or long code examples, please use <a href="https://gist.github.com/">GitHub gist</a> 
+and include only a few lines of the pertinent code / log within the email.</li>
+  <li>No jobs, sales, or solicitation is permitted on the Apache Spark mailing lists.</li>
+</ul>
 
 <p><a name="events"></a></p>
 <h3>Events and Meetups</h3>