alamb commented on code in PR #19714: URL: https://github.com/apache/datafusion/pull/19714#discussion_r2676306714
########## docs/source/contributor-guide/communication.md: ########## @@ -17,56 +17,56 @@ under the License. --> -# Communication +# Community Communication Review Comment: I think highlighting this is a related to community building may help the content be found more easily ########## 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`_. Review Comment: I also added another link to the communication page at the top of the intro to try and make sure it was easily discoverable ########## docs/source/contributor-guide/communication.md: ########## @@ -17,56 +17,56 @@ under the License. --> -# Communication +# Community Communication We welcome participation from everyone and encourage you to join us, ask questions, and get involved. - All participation in the Apache DataFusion project is governed by the Apache Software Foundation's [code of conduct](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 tickets, 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 Review Comment: Moved discord to be listed first and also mentioned it was historically more active than slack I also removed the explicit list of channels as it is pretty clear now from the channel names in the discord sever what channels are datafusion related <img width="675" height="912" alt="Image" src="https://github.com/user-attachments/assets/2a61f73a-6d65-44ab-91b2-8fa4c4e8efde"; /> -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
