From e084101ae0b8b79ec16ed3c169993895007a52d3 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Mon, 29 Apr 2024 07:47:45 -0400 Subject: [PATCH 1/3] Add mailing list descriptions to documentation --- .../source/contributor-guide/communication.md | 41 +++++++++++++------ 1 file changed, 29 insertions(+), 12 deletions(-) diff --git a/docs/source/contributor-guide/communication.md b/docs/source/contributor-guide/communication.md index 3e5e816d2f90..fae1b821046e 100644 --- a/docs/source/contributor-guide/communication.md +++ b/docs/source/contributor-guide/communication.md @@ -37,18 +37,35 @@ We use the Slack and Discord platforms for informal discussions and coordination 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. -Most of us use the `#datafusion` and `#arrow-rust` channels in the [ASF Slack workspace](https://s.apache.org/slack-invite) . -Unfortunately, due to spammers, the ASF Slack workspace requires an invitation to join. To get an invitation, -request one in the `Arrow Rust` channel of the [Arrow Rust Discord server](https://discord.gg/Qw5gKqHxUM). +Most of us use the `#datafusion` and `#arrow-rust` channels in the [ASF Slack +workspace](https://s.apache.org/slack-invite) and the [Arrow Rust Discord +server](https://discord.gg/Qw5gKqHxUM) for discussions. -## Mailing list +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. -We also use arrow.apache.org's `dev@` mailing list for release coordination and occasional design discussions. Other -than the release process, most DataFusion mailing list traffic will link to a GitHub issue or PR for discussion. -([subscribe](mailto:dev-subscribe@datafusion.apache.org), -[unsubscribe](mailto:dev-unsubscribe@datafusion.apache.org), -[archives](https://lists.apache.org/list.html?dev@arrow.apache.org)). +## Mailing Lists -When emailing the dev list, please make sure to prefix the subject line with a -`[DataFusion]` tag, e.g. `"[DataFusion] New API for remote data sources"`, so -that the appropriate people in the Apache Arrow community notice the message. +Like 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 +the actual discussion occurs. The project mailing lists are: + +- [`dev@datafusion.apache.org`](mailto:dev@datafusion.apache.org): the main + mailing list for release coordination and other project-wide discussions. Links: + [archives](https://lists.apache.org/list.html?dev@datafusion.apache.org), + [subscribe](mailto:dev-subscribe@datafusion.apache.org), + [unsubscribe](mailto:dev-unsubscribe@datafusion.apache.org) +- `github@datafusion.apache.org`: read-only mailing list that receives all GitHub notifications for the project. Links: + [archives](https://lists.apache.org/list.html?github@datafusion.apache.org) +- `commits@datafusion.apache.org`: read-only mailing list that receives all GitHub commits for the project. Links: + [archives](https://lists.apache.org/list.html?commits@datafusion.apache.org) +- `private@datafusion.apache.org`: private mailing list for PMC members. This list has very little traffic, almost exclusively discussions on growing the committer and PMC membership. Links: + [archives](https://lists.apache.org/list.html?private@datafusion.apache.org) + +[mailing lists]: https://www.apache.org/foundation/mailinglists + +``` + +``` From f37f6c5167355aafbaef489c02077c0376752ffe Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Mon, 29 Apr 2024 07:50:30 -0400 Subject: [PATCH 2/3] remove random ```` --- docs/source/contributor-guide/communication.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/source/contributor-guide/communication.md b/docs/source/contributor-guide/communication.md index fae1b821046e..38ae6b6651cf 100644 --- a/docs/source/contributor-guide/communication.md +++ b/docs/source/contributor-guide/communication.md @@ -64,8 +64,4 @@ the actual discussion occurs. The project mailing lists are: - `private@datafusion.apache.org`: private mailing list for PMC members. This list has very little traffic, almost exclusively discussions on growing the committer and PMC membership. Links: [archives](https://lists.apache.org/list.html?private@datafusion.apache.org) -[mailing lists]: https://www.apache.org/foundation/mailinglists - -``` - -``` +[mailing lists]: https://www.apache.org/foundation/mailinglists \ No newline at end of file From e22bec37ec870d85d78f21c11e06447963c63825 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Mon, 29 Apr 2024 07:53:09 -0400 Subject: [PATCH 3/3] prettoer --- docs/source/contributor-guide/communication.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/contributor-guide/communication.md b/docs/source/contributor-guide/communication.md index 38ae6b6651cf..40cb28bbde00 100644 --- a/docs/source/contributor-guide/communication.md +++ b/docs/source/contributor-guide/communication.md @@ -64,4 +64,4 @@ the actual discussion occurs. The project mailing lists are: - `private@datafusion.apache.org`: private mailing list for PMC members. This list has very little traffic, almost exclusively discussions on growing the committer and PMC membership. Links: [archives](https://lists.apache.org/list.html?private@datafusion.apache.org) -[mailing lists]: https://www.apache.org/foundation/mailinglists \ No newline at end of file +[mailing lists]: https://www.apache.org/foundation/mailinglists