diff options
author | Sean Owen <sowen@cloudera.com> | 2016-11-16 13:55:08 +0000 |
---|---|---|
committer | Sean Owen <sowen@cloudera.com> | 2016-11-17 11:02:10 +0000 |
commit | 80a543b56076af07e75b42bb72347710be46b437 (patch) | |
tree | 3d92ef93643393a94e0a966ec02a047b0208708b | |
parent | 8781cd3c4b6e58c131b62ee251be50dec6939106 (diff) | |
download | spark-website-80a543b56076af07e75b42bb72347710be46b437.tar.gz spark-website-80a543b56076af07e75b42bb72347710be46b437.tar.bz2 spark-website-80a543b56076af07e75b42bb72347710be46b437.zip |
Expand guidance on SO and mailing lists, per discussion
-rw-r--r-- | community.md | 48 | ||||
-rw-r--r-- | site/community.html | 61 |
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’ 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> |