title: How to Use Email sidebar_position: 1.1
Introduces mailing list usage guidelines and reference examples
To subscribe to the mailing list, please refer to this Subscription Guidelines
Linkis' archived mail can be viewed here archived mail
:::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.
- [PROPOSAL] Proposals, such as adding/removing certain features, are not much different from [DISCUSS]
- [VOTE] Vote for changes/elect Committer/elect new PMC members, etc., such as version release, each version will be voted on in the community dev mailing list; you can also choose multiple options ,Poll.
- [ANNOUNCE] Announce the completion of the release of the new version, announcing the new Committer/PMC members elected, etc.
- [NOTICE] Mainly used to notify some temporary announcements, etc., such as the community sandbox environment is suspended for maintenance/upgrade, the web official website is abnormally unavailable, etc.; as well as online and offline weekly meetings/exchange meetings and various Event information announcements, etc.
- [HELP] Ask for help, because there are many git code notifications, and sometimes it is impossible to check them in time; in addition, github network access is limited, and some students may not be able to submit issues through github smoothly. Initiated by email, it is easier to identify and be perceived.
- [VOTE][RESULT] Announce the results of the release vote
2. Mail specifications
** 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/PMC members initiate email discussions/needs for help/notifications for the content of the above scenarios, please send them to dev@linkis.apache.org
- 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
** 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 PMC 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 **
- Title
[DISCUSS][module name] XXXX
(if it is a specific module, it is recommended to bring the module name) - Generally, create a corresponding issue on Github's issues column, and then initiate an email discussion
- Briefly describe clearly the content of the discussion/proposal (eg: background/what problem you want to solve/how to solve it)
- Modules involved (if one or two specific modules are involved)
- Graphical and textual information such as relevant design instructions can be placed in the corresponding issue for easy modification, and the link can be quoted in the email.
- The corresponding Chinese translation can be attached
** [HELP] Mail**
3. Sample reference
** [DISCUSS/Proposal] Example**
** [VOTE] Example**
** [ANNOUNCE] Example**
** [NOTICE] Example**
** [HELP] Example**
4. Mail usage of PMC
From the determination of a version to the release, it may involve specific common scenarios of using email
- The new version needs to organize PMC members and developers to discuss, record the minutes of the meeting, determine the function points of this version, the general release time of the plan, and the release manager of this time, etc., and send the meeting minutes private@linkis.apache.org Email list.
- For the scope of the feature list of the new version, you need to send a voting email to dev@linkis.apache.org, and 3+ PMC members are required to agree and the yes votes are greater than the negative votes.
- For the weekly regular meeting hosted, the meeting invitation reminder email needs to be released before the meeting / the meeting minutes email should be sent to the dev@linkis.apache.org mailbox after the meeting
- New committer/PMC members votes need to be sent to private@linkis.apache.org. See https://community.apache.org/newcommitter.html for the new committee/PMC members selection process
5. How to reply to version release voting emails
If a release vote is initiated, after verification (see How to verify for the detailed verification process), you can refer to this reply example for email reply
If you initiate a posting vote, you can refer to this response example to reply to the email after verification When replying to the email, you must bring the information that you have checked by yourself. Simply replying to +1 approve
is invalid.
PMC member voting is best with the binding suffix, indicating a binding vote, which is convenient for counting voting results
Non-PMC member
+1 (non-binding)
I checked:
1. All download links are valid
2. Checksum and signature are OK
3. LICENSE and NOTICE are exist
4. Build successfully on macOS(Big Sur)
5.
PMC member
+1 (binding)
I checked:
1. All download links are valid
2. Checksum and signature are OK
3. LICENSE and NOTICE are exist
4. Build successfully on macOS(Big Sur)
5.
6. Appendix
** QQ mailbox switch to plain text format **
** Email configuration reply default subject keywords ** Chinese Reply:
There will be problems
Modify general mailbox settings