CANN社区邮件列表使用指南:订阅、退订、公共存档与邮件投递实操
【免费下载链接】infrastructure本仓库用于托管CANN社区基础设施团队的公开信息,包括不限于:会议日程,成员信息,服务文档和配置等信息项目地址: https://gitcode.com/cann/infrastructure
CANN社区通过自建的邮件列表服务(mailweb.cann.osinfra.cn)为各 SIG 组与子项目提供异步沟通渠道,本文完整讲解从浏览、订阅、退订到查阅历史存档、向列表投递邮件的全流程操作,并结合本仓库的服务矩阵与会议指南说明其实际应用场景。读完本文,你将能够独立完成邮件列表的订阅与退订、通过确认邮件完成身份校验,并学会使用 Archives 公共存档追溯任意列表的历史讨论。
一、服务概览:CANN社区的邮件列表是什么
邮件列表(Mailing List)是开源社区最经典的异步协作方式之一:成员将邮件发送到列表地址,所有订阅者都能收到讨论邮件,历史讨论则沉淀为可检索的公共存档。CANN 社区邮件列表服务提供订阅(Subscribe)、退订(Unsubscribe)、公共存档(Archives)三大核心能力,社区成员可以按兴趣订阅一个或多个组织的邮件列表。
- 服务入口:
https://mailweb.cann.osinfra.cn - 定位:社区基础设施服务的组成部分。在 docs/services.md 的基础设施支撑矩阵中,"社区邮件列表"作为独立支撑项列出,服务地址即
https://mailweb.cann.osinfra.cn/,使用指导指向本文档(docs/mail-list/邮件列表使用指南.md)。 - 实际用途:邮件列表不仅是讨论渠道,也是社区运作的正式通知渠道。在 CANN社区会议指南 中明确要求:会议通知通过邮件列表发送,会议议程需提前 2~3 天通过邮件列表发出,发送成功后可在对应邮件列表的归档中查看通知邮件。这意味着掌握本文的订阅与存档查询操作,是参与 CANN 社区协作的基础技能。
邮件列表服务主页以表格形式展示所有可用列表,每个列表包含三列关键信息:
| 列名 | 含义 |
|---|---|
| List name | 列表名称,如aal、ascendc |
| Post address | 列表投递地址,格式如aal@cann.osinfra.cn,向该地址发邮件即向全体订阅者投递 |
| Description | 列表用途描述,用于判断是否与你的关注领域相关 |
二、订阅邮件列表
订阅分为"浏览选择"与"确认订阅"两个阶段:先找到感兴趣的列表,再通过邮箱验证完成订阅。
2.1 浏览邮件列表的两种方式
方法一:从 SIG 组列表进入。浏览 CANN 社区的 SIG 组列表,选择感兴趣的组织并订阅其邮件。每个 SIG 组的 README 页面会提供"邮件订阅"入口,同时在页面中可以看到该 SIG 的 Committer 成员列表、会议组织与纪要等运作信息,帮助你判断该 SIG 是否符合关注方向。
方法二:直接进入邮件列表服务。打开邮件列表服务主页,在列表中浏览全部可用邮件列表,直接选择其中一个进行订阅。
2.2 填写订阅表单
点击进入你感兴趣的组织后,填写订阅表单:
- Your email address:填写你的邮箱地址(必填),后续订阅确认将发送到此邮箱。
- Your name:填写你的名字(可选),用于在列表中标识你的身份。
- 同意条款复选框:勾选隐私声明与社区行为准则两个同意选项,表示你接受列表的隐私条款和社区行为规范。
- 点击Subscribe按钮提交订阅请求。
2.3 完成邮箱确认
出于防滥用与身份校验的考虑,订阅采用**双重确认(Double Opt-in)**机制:提交订阅表单后并不会立即生效,你需要前往填写的邮箱完成个人身份确认:
- 登录你在表单中填写的邮箱,查收订阅确认邮件(邮件中包含发件人、收件人、时间与一条确认链接)。
- 点击邮件中的确认链接,进入确认页面。
- 在确认页面核对订阅信息(例如页面会显示
Confirm subscription of yourmail@example.com to hccl (hccl@cann.osinfra.cn)这类信息),点击绿色Confirm按钮,即完成订阅。
2.4 订阅成功
确认完成后,页面会显示订阅成功提示("Mailbox subscription mailing list success"),并展示该列表的所有者邮箱(格式如hccl-owner@cann.osinfra.cn,用于联系列表管理员)以及Archives存档链接。此后你订阅的列表若有新邮件,你都会收到副本。
三、取消订阅
退订与订阅流程对称,同样需要邮箱验证,但退订不需要点击 Confirm 按钮,点击确认链接即生效:
- 在邮件列表服务主页的列表中选择你想退订的邮件地址并点击进入。
- 在退订表单中输入你的邮箱地址,点击Unsubscribe按钮。
- 前往该邮箱查收退订确认邮件,点击邮件中的确认链接即可成功取消订阅。
注意:取消订阅时不需要 Confirm,点击链接即可成功取消订阅。这与订阅流程的差异是刻意设计的,退订应尽可能减少用户操作步骤。
四、邮件列表的公共存档(Archives)
邮件列表服务提供Archives模块,用来存放和查阅某个邮件列表的所有历史邮件,是追溯社区讨论、查找历史决策的一手资料源:
- 在邮件列表服务页面点击Archives标签进入存档模块。
- 存档模块展示可用列表("Available lists"),包含列表名称(如
TSC@cann.osinfra.cn)、描述以及活动数据(participants 参与者数量、discussions 讨论数量)。 - 存档页支持Most popular、Most active等排序方式,并提供搜索框,便于按列表或关键词定位历史讨论。
由于会议通知会通过邮件列表发出并沉淀在归档中,Archives 也是确认通知是否送达、回顾会议议题与讨论过程的重要途径(参见 CANN社区会议指南 中对归档查看的说明)。
五、向邮件列表发送邮件
订阅之后,你即可参与列表讨论。向邮件列表投递邮件的方式很简单:
- 在邮件客户端(或网页邮箱)中新建邮件,收件人填写目标列表的Post address(如
aal@cann.osinfra.cn,具体地址以邮件列表服务主页各列表的 Post address 列显示为准)。 - 发送成功后,邮件会投递给该列表的所有订阅者,并自动进入该列表的公共存档,供未及时阅读的成员与后来者查阅。
在社区运作中,这一机制被广泛用于正式通知:例如会议组织者通过邮件列表发送会议通知与议程,参会人员通过订阅接收通知,通知邮件随后可在对应列表的归档中检索验证(参见 CANN社区会议指南)。
六、问题反馈与支撑联系
如在使用邮件列表过程中遇到异常(如订阅/退订确认邮件未收到、列表归档缺失等),可通过基础设施支撑矩阵寻求帮助。根据 docs/services.md,"社区邮件列表"支撑项的使用指导即本文档,社区成员可在本仓库提交 issue 反馈问题,基础设施团队会及时跟进处理。
相关文档
- 服务列表与基础设施支撑矩阵:查看邮件列表服务的地址、支撑人与联系方式
- CANN社区会议指南:了解通过邮件列表发送会议通知、归档查阅的完整流程
【免费下载链接】infrastructure本仓库用于托管CANN社区基础设施团队的公开信息,包括不限于:会议日程,成员信息,服务文档和配置等信息项目地址: https://gitcode.com/cann/infrastructure
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考