You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@spark.apache.org by sr...@apache.org on 2016/11/18 09:40:35 UTC
spark-website git commit: Expand guidance on SO and mailing lists,
per discussion
Repository: spark-website
Updated Branches:
refs/heads/asf-site 8781cd3c4 -> 80a543b56
Expand guidance on SO and mailing lists, per discussion
Project: http://git-wip-us.apache.org/repos/asf/spark-website/repo
Commit: http://git-wip-us.apache.org/repos/asf/spark-website/commit/80a543b5
Tree: http://git-wip-us.apache.org/repos/asf/spark-website/tree/80a543b5
Diff: http://git-wip-us.apache.org/repos/asf/spark-website/diff/80a543b5
Branch: refs/heads/asf-site
Commit: 80a543b56076af07e75b42bb72347710be46b437
Parents: 8781cd3
Author: Sean Owen <so...@cloudera.com>
Authored: Wed Nov 16 13:55:08 2016 +0000
Committer: Sean Owen <so...@cloudera.com>
Committed: Thu Nov 17 11:02:10 2016 +0000
----------------------------------------------------------------------
community.md | 48 ++++++++++++++++++++++++++++++++++---
site/community.html | 61 +++++++++++++++++++++++++++++++++++++++++++++---
2 files changed, 103 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/spark-website/blob/80a543b5/community.md
----------------------------------------------------------------------
diff --git a/community.md b/community.md
index 480d05a..c4f83a5 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>
http://git-wip-us.apache.org/repos/asf/spark-website/blob/80a543b5/site/community.html
----------------------------------------------------------------------
diff --git a/site/community.html b/site/community.html
index 79ab192..fe4aa35 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’ questions and answers.</p>
+
+<p>Some quick tips when using StackOverflow:</p>
+
+<ul>
+ <li>Prior to asking submitting questions, please:
+ <ul>
+ <li>Search StackOverflow’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>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@spark.apache.org
For additional commands, e-mail: commits-help@spark.apache.org