This is an automated email from the ASF dual-hosted git repository.
casion pushed a commit to branch dev
in repository https://gitbox.apache.org/repos/asf/incubator-linkis-website.git
The following commit(s) were added to refs/heads/dev by this push:
new 2568560a99 Mailbox guidance document adjustment (#590)
2568560a99 is described below
commit 2568560a9921e9daa4a5e0d35532d48cfddf7932
Author: 成彬彬 <[email protected]>
AuthorDate: Fri Nov 25 00:26:09 2022 +0800
Mailbox guidance document adjustment (#590)
* Mailbox guidance document adjustment
Co-authored-by: casionone <[email protected]>
---
community/how-to-email.md | 35 +++++++++++++++++++--
community/how-to-subscribe.md | 5 +++
.../current/how-to-email.md | 27 ++++++++++++++--
.../current/how-to-subscribe.md | 7 +++++
static/Images-zh/Architecture/email-reply.png | Bin 0 -> 105070 bytes
static/Images-zh/Architecture/mailbox-settings.png | Bin 0 -> 91564 bytes
static/Images/Architecture/email-reply.png | Bin 0 -> 105070 bytes
static/Images/Architecture/mailbox-settings.png | Bin 0 -> 91564 bytes
8 files changed, 68 insertions(+), 6 deletions(-)
diff --git a/community/how-to-email.md b/community/how-to-email.md
index 8d7e10e37f..fbf08587b0 100644
--- a/community/how-to-email.md
+++ b/community/how-to-email.md
@@ -9,6 +9,17 @@ To subscribe to the mailing list, please refer to this
[Subscription Guidelines]
Linkis' archived mail can be viewed here [archived
mail](https://lists.apache.org/[email protected])
+:::caution Notice
+Since mailbox 163/sina replies with Chinese "reply" by default, it will cause
the apache mail to be recognized as a new thread mail.
+The following takes 163 mailboxes as an example:
+:::
+
+
+
+**Therefore, you need to modify the general settings of the mailbox**
+
+
+
## 1. Themes
The subject of the email can be roughly divided into the following types
- **\[DISCUSS]** Discussion on a feature/function/logic modification/CI/CD,
which can be implementation/design/optimization suggestion, etc.
@@ -22,13 +33,23 @@ The subject of the email can be roughly divided into the
following types
## 2. Mail specifications
-:::caution general specification
+
+** General**
- Whenever possible do not send plain HTML messages, but plain text. If you
use QQ mailbox, its email content is in html format by default. Please switch
to plain text text format when writing. For detailed switching instructions,
see the appendix of this article.
- Developers/community users/PPMC members initiate email discussions/needs for
help/notifications for the content of the above scenarios, please send them to
[email protected]
- Please put the corresponding type prefix before the email subject: such as
`[HELP] XXXXXXX`, `[DISCUSS] XXXXXXX`
For more information, please refer to the official [Mail
Etiquette](https://infra.apache.org/contrib-email-tips)
https://infra.apache.org/contrib-email-tips
-:::
+
+** Reply **
+
+- At the end of the email content, it is best to bring your own signature
(English)
+- If it is a reply to a voting email, it is best to bring a binding mark
(votes cast by PPMC/IPMC members are binding, you can add a binding suffix such
as: `+1 approve(binding)`;
+Votes cast by ordinary members, non-binding, can be added with non-binding
suffix such as: `+1 approve(non-binding)` )
+- When some mailboxes such as: 163/sina reply to emails, the default is to
bring the Chinese `reply`, which will cause the apache email to be recognized
as a new thread email
+For example: https://lists.apache.org/thread/otfftdtbq0z9xsddnl7wb8tgzkhqcnof,
the threads of the entire mail cannot be connected in series,
+Therefore, it is necessary to modify the configuration of the email reply. For
detailed switching guidelines, see the appendix of this article.
+
** \[DISCUSS/Proposal] Mail **
@@ -115,4 +136,12 @@ I checked:
## 6. Appendix
** QQ mailbox switch to plain text format **
-
\ No newline at end of file
+
+
+
+** Email configuration reply default subject keywords **
+Chinese `Reply: `There will be problems
+
+
+Modify general mailbox settings
+
\ No newline at end of file
diff --git a/community/how-to-subscribe.md b/community/how-to-subscribe.md
index b5dc9754f7..155cdfc2a9 100644
--- a/community/how-to-subscribe.md
+++ b/community/how-to-subscribe.md
@@ -44,3 +44,8 @@ The steps for unsubscribing to a mailing list are similar to
those for subscribi
For new problem/ideas, you can create a new issue through \[new issues\], and
describe the issues in detail as much as possible, so that community members
can follow up, discuss and solve them. For any problems of the project, it is
recommended to create issues first to record and follow up, so that the entire
process can be well preserved and archived to facilitate subsequent users to
retrieve.
For existing issues, if you are interested, you can reply and discuss as much
as you want. For tasks/bug-type issues, if you are interested, you can follow
or directly participate in the task. Community partners are very welcome to
contribute their efforts to Linkis.
+
+
+## 4. Mail usage
+
+Please refer to [How to use the mailing list](./how-to-email.md) for email
specifications and tips
\ No newline at end of file
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/how-to-email.md
b/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/how-to-email.md
index 128b0ac331..b327161450 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/how-to-email.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/how-to-email.md
@@ -9,6 +9,7 @@ sidebar_position: 1.1
Linkis的存档邮件可以在此处查看[存档邮件](https://lists.apache.org/[email protected])
+
## 1. 主题种类
邮件的主题可以大体分为以下几种类型
- **\[DISCUSS]** 针对某一特性/功能/逻辑修改/CI/CD的讨论，可以是实现方式/设计/优化建议等等
@@ -22,13 +23,25 @@ Linkis的存档邮件可以在此处查看[存档邮件](https://lists.apache.or
## 2. 邮件规范
-:::caution 通用规范
-- 尽可能不要发送纯 HTML 消息，而是发送纯文本。如果使用QQ邮箱，其邮件内容默认使用的是html格式，编写时请先切换至纯文本格式，详细切换指引见本文附录
+
+** 通用规范 **
+
+- 尽可能不要发送纯 HTML 内容，而是发送纯文本。如果使用QQ邮箱，其邮件内容默认使用的是html格式，编写时请先切换至纯文本格式，详细切换指引见本文附录
- 开发者/社区用户/PPMC成员针对以上场景的内容，发起邮件讨论/需求帮助/通知事宜等，请发送至[email protected]邮箱
- 邮件标题前请带上对应的类型前缀：如`[HELP] XXXXXXX`,`[DISCUSS] XXXXXXX`
更多可以参阅官方[邮件规范](https://infra.apache.org/contrib-email-tips)
https://infra.apache.org/contrib-email-tips
-:::
+
+
+** 回复规范**
+
+- 邮件内容末尾，最好带上自己的署名(英文)
+- 如果是回复投票类的邮件，最好带上是否具有约束性的标识(PPMC/IPMC成员投的票具有约束性，可以加上 binding后缀 如：`+1
approve(binding)`;
+普通成员投的票，无约束性，可以加上 non-binding后缀 如：`+1 approve(non-binding)` )
+- 由于部分邮箱如:163/sina 在进行邮件回复时，默认是带上的中文`回复`会导致apache 邮件识别为一封新线程邮件
+如：https://lists.apache.org/thread/otfftdtbq0z9xsddnl7wb8tgzkhqcnof，
无法将整个邮件的线程串联起来，
+所以需要对邮箱的回复进行修改配置，详细切换指引见本文附录
+
** \[DISCUSS/Proposal] 邮件 **
@@ -114,3 +127,11 @@ I checked:
** QQ邮箱切换纯文本格式 **
+
+** 邮箱配置回复默认主题关键字 **
+中文`回复：`会存在问题
+
+
+修改邮箱常规设置
+
+
\ No newline at end of file
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/how-to-subscribe.md
b/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/how-to-subscribe.md
index 8edef620a9..9999c1792d 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/how-to-subscribe.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/how-to-subscribe.md
@@ -10,6 +10,7 @@ Apache为每一个项目都配置了一系列的邮件列表，邮件列表作
只要订阅了这个邮件列表，可以第一时间获取Linkis社区的最新动态，与社区保持同步。
+
**Linkis项目邮件列表**
|名称|描述|订阅邮件|退订邮件|邮件归档|
@@ -46,3 +47,9 @@ Apache为每一个项目都配置了一系列的邮件列表，邮件列表作
对于新的问题/想法 可以通过new issues
来创建一个新的issues，尽可能将issues描述详细，方便社区人员跟进探讨解决。项目的任何问题都建议优先创建issues来记录跟进，这样能很好的保留存档整个过程，方便后续用户进行检索。
对于已有的issues，如果你感兴趣可以尽情的回复探讨，对于任务/bug类型issues，如果你感兴趣可以关注或则直接参与到任务中。非常欢迎社区小伙伴为Linkis贡献自己的力量。
+
+
+## 4. 邮件使用事项
+
+邮件的规范和注意事项见[如何使用邮件列表](./how-to-email.md))
+
diff --git a/static/Images-zh/Architecture/email-reply.png
b/static/Images-zh/Architecture/email-reply.png
new file mode 100644
index 0000000000..8bcf024e20
Binary files /dev/null and b/static/Images-zh/Architecture/email-reply.png
differ
diff --git a/static/Images-zh/Architecture/mailbox-settings.png
b/static/Images-zh/Architecture/mailbox-settings.png
new file mode 100644
index 0000000000..b036b8e921
Binary files /dev/null and b/static/Images-zh/Architecture/mailbox-settings.png
differ
diff --git a/static/Images/Architecture/email-reply.png
b/static/Images/Architecture/email-reply.png
new file mode 100644
index 0000000000..8bcf024e20
Binary files /dev/null and b/static/Images/Architecture/email-reply.png differ
diff --git a/static/Images/Architecture/mailbox-settings.png
b/static/Images/Architecture/mailbox-settings.png
new file mode 100644
index 0000000000..b036b8e921
Binary files /dev/null and b/static/Images/Architecture/mailbox-settings.png
differ
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
