注意: 虽然 JavaScript 对于本网站不是必需的,但您与内容的互动将受到限制。请开启 JavaScript 以获得完整的体验。

Python 特别兴趣小组 - 指南

Python SIG 创建指南

创建新 SIG 的指南比较非正式,但有几项关键事项是必需的。首先,我们概述 SIG 的总体框架,然后描述如果您希望我们创建新 SIG,您需要做什么。

SIG 邮件列表由 GNU Mailman 管理,这是一个用 Python 编写的基于网络的邮件列表界面。订阅/取消订阅请求、邮件存档等都自动进行,无需人工干预。这是一件好事(TM),因为此类响应应该处理得非常快。(虽然与邮件列表交互的常规方式是通过 SIG 的“listinfo”网页,但也可以向特殊的管理地址发送命令,详见下文。)

每个 SIG 都必须有一个明确的使命,有明确的结论和结束日期,并有一名协调员——一个具体的人负责报告 SIG 活动,并指导 SIG 的活动和收尾工作。如果活动需要,结束日期可以延长,但我们需要一个合理的收尾目标,以避免维护无效率的 SIG。

一旦您能满足这些标准,要创建一个 SIG,请将其提议到 meta-sig 邮件列表上进行讨论。如果您获得一致同意认为该 SIG 值得创建——特别是,没有其他 SIG 或一般的 Python 新闻组更适合——并且您的协调员已准备就绪,那么该 SIG 将被创建。

邮件列表框架

每个邮件列表都有一个简短的名称,例如“gui”。对于每个 SIG,有三个特殊地址:

  • <name>-sig@python.org:用于向 SIG 邮件列表发布消息的地址。发送到此地址的任何内容都会转发给所有列表成员,并自动存档。请注意您发送到此地址的内容!
  • <name>-sig-request@python.org:这是一个电子邮件机器人地址,可以处理订阅和删除请求、帮助请求以及其他 Mailman 电子邮件命令。通常,这些消息不会被人看到或处理。如需更多帮助,请向此地址发送一封邮件,并在Subject标题中包含“help”一词。
  • <name>-sig-owner@python.org:这是一个别名,可以联系 SIG 邮件列表的管理员。这个人将管理邮件列表的具体事宜,例如订阅/取消订阅审批(如有必要)、批准被暂存的帖子等。此地址的另一端始终是真人,因此如果您需要联系真人,请使用此地址。

邮件列表策略

每个邮件列表都有关于谁可以加入列表或发布消息等方面的策略。通常,所有 SIG 列表都遵循以下(相当宽松的)策略。SIG 所有者拥有自己的 Mailman 网络界面,因此他们可以在没有我们帮助的情况下更改策略。

  • 订阅对所有人开放。只有当订阅地址与订阅消息的邮件头不匹配时,才需要审批。
  • 任何人都可以向列表发布消息,即使他们不是列表成员。列表不会被审核。

创建指南

那么您想创建一个新的 SIG 邮件列表吗?好的,这就是您需要做的。最重要的是,您必须对您的列表负责。这意味着我们将把 <name>-sig-owner@python.org 别名指向您的个人邮箱:-)。您不会经常被骚扰(希望如此),但偶尔可能需要处理订阅审批,并且每当有人订阅或取消订阅时,您都会收到可忽略的通知消息。您最重要的工作可能是丢弃发送到您的列表但被 Mailman 合理暂存的垃圾邮件。

您应该确定您的主题是什么以及其范围。尽量使其集中,并确保您验证没有其他 SIG 涵盖您的主题。您需要写两件事。首先,您应该写一段关于您的 SIG 的简短信息性介绍;只需一些可以放在 SIG 简短列表中的内容,例如“C++ 绑定开发”。

您还需要写一段稍长的介绍,最终将用于 SIG 的网页。例如,这是 meta SIG 的信息页面。包含您认为必要的尽可能多的信息,但尽量保持相当简短和简洁。

您应该在 meta SIG 邮件列表上讨论您提议的 SIG。介绍您的提案,并附上两段介绍的草稿,以便我们都可以讨论新 SIG 的优点。如果大家一致同意创建,我们将设置必要的基础设施并与您沟通细节。