Direct people to stackoverflow for questions about usage. (ray-projec…

…t#3830)

* Direct people to stackoverflow for questions about usage.

* Improve wording

.github/ISSUE_TEMPLATE.md

@@ -1,5 +1,7 @@
 <!--
 General questions should be asked on the mailing list [email protected].
+Questions about how to use Ray should be asked on
+[StackOverflow](https://stackoverflow.com/questions/tagged/ray).
 
 Before submitting an issue, please fill out the following form.
 -->

CONTRIBUTING.rst

@@ -4,9 +4,12 @@ Contributing to Ray
 Reporting bugs and asking questions
 -----------------------------------
 
-We use `GitHub issues`_ for bug reports and feature requests. For discussions
-about development, questions about usage, or any general questions, we use our
-mailing list `[email protected]`_.
+You can post questions or issues or feedback through the following channels:
+
+1. `[email protected]`_: For discussions about development or any general
+ questions and feedback.
+2. `StackOverflow`_: For questions about how to use Ray.
+3. `GitHub Issues`_: For bug reports and feature requests.
 
 To contribute a patch:
 ----------------------
@@ -17,5 +20,6 @@ To contribute a patch:
 3. Make sure that your code passes the unit tests.
 4. Add new unit tests for your code.
 
-.. _`GitHub issues`: https://github.com/ray-project/ray/issues
 .. _`[email protected]`: https://groups.google.com/forum/#!forum/ray-dev
+.. _`GitHub Issues`: https://github.com/ray-project/ray/issues
+.. _`StackOverflow`: https://stackoverflow.com/questions/tagged/ray

README.rst

@@ -73,10 +73,13 @@ More Information
 Getting Involved
 ----------------
 
-- Ask questions on our mailing list `[email protected]`_.
-- Please report bugs by submitting a `GitHub issue`_.
-- Submit contributions using `pull requests`_.
+- `[email protected]`_: For discussions about development or any general
+ questions.
+- `StackOverflow`_: For questions about how to use Ray.
+- `GitHub Issues`_: For reporting bugs and feature requests.
+- `Pull Requests`_: For submitting code contributions.
 
 .. _`[email protected]`: https://groups.google.com/forum/#!forum/ray-dev
-.. _`GitHub issue`: https://github.com/ray-project/ray/issues
-.. _`pull requests`: https://github.com/ray-project/ray/pulls
+.. _`GitHub Issues`: https://github.com/ray-project/ray/issues
+.. _`StackOverflow`: https://stackoverflow.com/questions/tagged/ray
+.. _`Pull Requests`: https://github.com/ray-project/ray/pulls

doc/source/autoscaling.rst

@@ -295,9 +295,11 @@ Questions or Issues?
 
 You can post questions or issues or feedback through the following channels:
 
-1. `Our Mailing List`_: For discussions about development, questions about
- usage, or any general questions and feedback.
-2. `GitHub Issues`_: For bug reports and feature requests.
+1. `[email protected]`_: For discussions about development or any general
+ questions and feedback.
+2. `StackOverflow`_: For questions about how to use Ray.
+3. `GitHub Issues`_: For bug reports and feature requests.
 
-.. _`Our Mailing List`: https://groups.google.com/forum/#!forum/ray-dev
+.. _`[email protected]`: https://groups.google.com/forum/#!forum/ray-dev
+.. _`StackOverflow`: https://stackoverflow.com/questions/tagged/ray
 .. _`GitHub Issues`: https://github.com/ray-project/ray/issues

doc/source/contact.rst

@@ -3,9 +3,11 @@ Contact
 
 The following are good places to discuss Ray.
 
-1. `Our Mailing List`_: For discussions about development, questions about
- usage, or any general questions.
-2. `GitHub Issues`_: For bug reports and feature requests.
+1. `[email protected]`_: For discussions about development or any general
+ questions.
+2. `StackOverflow`_: For questions about how to use Ray.
+3. `GitHub Issues`_: For bug reports and feature requests.
 
-.. _`Our Mailing List`: https://groups.google.com/forum/#!forum/ray-dev
+.. _`[email protected]`: https://groups.google.com/forum/#!forum/ray-dev
 .. _`GitHub Issues`: https://github.com/ray-project/ray/issues
+.. _`StackOverflow`: https://stackoverflow.com/questions/tagged/ray

doc/source/tune-usage.rst

@@ -486,9 +486,11 @@ Further Questions or Issues?
 
 You can post questions or issues or feedback through the following channels:
 
-1. `Our Mailing List`_: For discussions about development, questions about
- usage, or any general questions and feedback.
-2. `GitHub Issues`_: For bug reports and feature requests.
+1. `[email protected]`_: For discussions about development or any general
+ questions and feedback.
+2. `StackOverflow`_: For questions about how to use Ray.
+3. `GitHub Issues`_: For bug reports and feature requests.
 
-.. _`Our Mailing List`: https://groups.google.com/forum/#!forum/ray-dev
+.. _`[email protected]`: https://groups.google.com/forum/#!forum/ray-dev
+.. _`StackOverflow`: https://stackoverflow.com/questions/tagged/ray
 .. _`GitHub Issues`: https://github.com/ray-project/ray/issues