Apache DataFusion SQL Query Engine
docs: Refine Communication documentation to highlight Discord (#19714)
Andrew Lamb013efb4fe122
diff --git a/docs/source/contributor-guide/communication.md b/docs/source/contributor-guide/communication.mdindex 5d4561a351..ad80ea498f 100644--- a/docs/source/contributor-guide/communication.md+++ b/docs/source/contributor-guide/communication.md@@ -17,56 +17,56 @@under the License.-->-# Communication+# Community CommunicationWe welcome participation from everyone and encourage you to join us, askquestions, and get involved.-All participation in the Apache DataFusion project is governed by theApache Software Foundation's [code ofconduct](https://www.apache.org/foundation/policies/conduct.html).## GitHub-The vast majority of communication occurs in the open on our-[github repository](https://github.com/apache/datafusion) in the form of tickets, issues, discussions, and Pull Requests.+The primary means of communication is the+[GitHub repository](https://github.com/apache/datafusion) in the form of issues, discussions, and Pull Requests.+Our repository is open to everyone. We encourage you to+participate by reporting issues, asking questions, and contributing code.-## Slack and Discord+## Chat-We use the Slack and Discord platforms for informal discussions and coordination. These are great places to-meet other contributors and get guidance on where to contribute. It is important to note that any technical designs and-decisions are made fully in the open, on GitHub.+We also use the Discord and Slack platforms for lower latency, informal discussions and coordination.+These are great places to+meet other members of the community, ask questions, and brainstorm ideas.+However, to ensure technical discussions are archived and accessible to everyone,+all technical designs are recorded and formalized in GitHub issues.-Most of us use the [ASF Slack-workspace](https://s.apache.org/slack-invite) and the [Arrow Rust Discord-server][discord-link] for discussions.+### Discord-There are specific channels for Arrow, DataFusion, and the DataFusion subprojects (Ballista, Comet, Python, etc).+Historically, the most active discussion forum has been the [Arrow Rust Discord+server][discord-link] which has specific channels for Arrow, DataFusion, and+DataFusion subprojects such as Ballista, Comet, Python, etc.+DataFusion specific channels are prefixed with the `#datafusion-` tag.+We recommend new users join this server for real-time discussions with the community.-In Slack we use these channels:+### Slack-- #arrow-- #arrow-rust-- #datafusion-- #datafusion-ballista-- #datafusion-comet-- #datafusion-python+Some of the community also uses the [ASF Slack workspace] for discussions. This+has historically been much less active than the Discord server.+Unfortunately, due to spammers, the ASF Slack workspace [requires an invitation]+to join. We are happy to invite any community member -- please ask for an+invitation in the Discord server.-In Discord we use these channels:+[asf slack workspace]: https://the-asf.slack.com/+[requires an invitation]: https://s.apache.org/slack-invite-- #ballista-- #comet-- #contrib-federation-- #datafusion-- #datafusion-python-- #dolomite-optimizer-- #general-- #hiring-- #incremental-materialized-views+In Slack, we use these channels:-Unfortunately, due to spammers, the ASF Slack workspace requires an invitation-to join. We are happy to invite you -- please ask for an invitation in the-Discord server.+- `#arrow`+- `#arrow-rust`+- `#datafusion`+- `#datafusion-ballista`+- `#datafusion-comet`+- `#datafusion-python`### Job Board@@ -77,8 +77,8 @@ Please feel free to post links to DataFusion related jobs there.## Mailing ListsLike other Apache projects, we use [mailing lists] for certain purposes, most-importantly release coordination. Other than the release process, most-DataFusion mailing list traffic will simply link to a GitHub issue or PR where+importantly release coordination and announcing new committers and PMC members.+Other than these processes, most DataFusion mailing list traffic will link to a GitHub issue or PR wherethe actual discussion occurs. The project mailing lists are:- [`[email protected]`](mailto:[email protected]): the maindiff --git a/docs/source/index.rst b/docs/source/index.rstindex 9764e6c995..181d54a664 100644--- a/docs/source/index.rst+++ b/docs/source/index.rst@@ -61,7 +61,7 @@ The following related subprojects target end users and have separate documentati"Out of the box," DataFusion offers `SQL <https://datafusion.apache.org/user-guide/sql/index.html>`_and `Dataframe <https://docs.rs/datafusion/latest/datafusion/dataframe/struct.DataFrame.html>`_ APIs,excellent `performance <https://benchmark.clickhouse.com/>`_, built-in support for CSV, Parquet, JSON, and Avro,-extensive customization, and a great community.+extensive customization, and a great `community`_.`Python Bindings <https://github.com/apache/datafusion-python>`_ are also available.`Ballista <https://datafusion.apache.org/ballista/>`_ is Apache DataFusion extension enabling the parallelized execution of workloads across multiple nodes in a distributed environment.@@ -81,6 +81,7 @@ To get started, see.. _datafusion-examples: https://github.com/apache/datafusion/tree/main/datafusion-examples.. _developer’s guide: contributor-guide/index.html#developer-s-guide.. _library user guide: library-user-guide/index.html+.. _community: contributor-guide/communication.html.. _communication: contributor-guide/communication.html.. _toc.asf-links: