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/">us...@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 u...@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">u...@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/">us...@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/">us...@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 u...@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">u...@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/">us...@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-unsubscr...@spark.apache.org For additional commands, e-mail: commits-h...@spark.apache.org