From 88da2308e68eb3286d94fa4be340dcba3b595425 Mon Sep 17 00:00:00 2001 From: Bryce Mecum Date: Thu, 16 Feb 2023 16:37:42 -0900 Subject: [PATCH 1/3] Expand text about MLs on Community page Closes https://github.com/apache/arrow/issues/33989 --- community.md | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/community.md b/community.md index 3bde837e81dd..31c3aef9ea72 100644 --- a/community.md +++ b/community.md @@ -43,10 +43,29 @@ These arrow.apache.org mailing lists are for project discussion:
  • dev@ is for discussions about contributing to the project development {% include mailing_list_links.html list="dev" %}
    • +#### Tags + When emailing one of the lists, you may want to prefix the subject line with -one or more tags, like `[C++] why did this segfault?`, `[Python] trouble with -wheels`, etc., so that the appropriate people in the community notice the -message. +one or more tags so that the appropriate people in the community notice the +message. Depending the topic of your email, tags may include one or more: + +- Supported Enivronments: e.g., `[C++]`, `[Java]`, `[Python]`, etc. +- Specifications and Protocols: e.g., `[Format]`, `[Flight RPC]`, `[ADBC]`, etc. + +You may also prefix your subject line with `[DISCUSS]` if your email is intended +to prompt a discussion rather than get an answer to a specific question. + +#### Voting + +Votes are held periodically on the dev@ mailing list and are indicated by the +`[VOTE]` prefix. These votes are part of the formal [Apache Software Foundation +voting process](https://community.apache.org/committers/voting.html). Members of +the community are encouraged to engage with these posts by replying with a body +of "+1 (non-binding)" if they are in support of the respective proposal. The +result of a vote will be posted back to the dev@ mailing list with the prefix +`[VOTE][RESULT]`. + +#### Other Lists You may also wish to subscribe to these lists, which capture some activity streams: From 0ad7a4d6e7e4d839b2e3315a02e786a864d25bce Mon Sep 17 00:00:00 2001 From: Bryce Mecum Date: Wed, 22 Feb 2023 10:29:14 -0900 Subject: [PATCH 2/3] Update mailing lists section per feedback --- community.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/community.md b/community.md index 31c3aef9ea72..0120b5c6b5f8 100644 --- a/community.md +++ b/community.md @@ -45,9 +45,15 @@ These arrow.apache.org mailing lists are for project discussion: #### Tags -When emailing one of the lists, you may want to prefix the subject line with -one or more tags so that the appropriate people in the community notice the -message. Depending the topic of your email, tags may include one or more: +The mailing lists follow the convention of prefixing subjects with one or more +tags in order to clarify the scope and purpose of messages. For example: + +- [ANNOUNCE] Apache Arrow 11.0.0 released +- [DISCUSS][C++] C++ API as a user-facing API +- [Java][Arrow IPC] Extreme memory usage when reading feather files + +When emailing one of the lists, please prefix the subject line with one or more +tags. Depending the topic of your email, tags may include one or more: - Supported Enivronments: e.g., `[C++]`, `[Java]`, `[Python]`, etc. - Specifications and Protocols: e.g., `[Format]`, `[Flight RPC]`, `[ADBC]`, etc. From 5222884e8314aa9e56b4826bfe382fb928022499 Mon Sep 17 00:00:00 2001 From: Bryce Mecum Date: Wed, 29 Mar 2023 15:45:03 -0800 Subject: [PATCH 3/3] Update community.md Co-authored-by: Sutou Kouhei --- community.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/community.md b/community.md index 0120b5c6b5f8..14afdc0ea7e9 100644 --- a/community.md +++ b/community.md @@ -69,7 +69,7 @@ voting process](https://community.apache.org/committers/voting.html). Members of the community are encouraged to engage with these posts by replying with a body of "+1 (non-binding)" if they are in support of the respective proposal. The result of a vote will be posted back to the dev@ mailing list with the prefix -`[VOTE][RESULT]`. +`[RESULT][VOTE]`. #### Other Lists