Gothub 邮件列表

# Game of Trees Hub 来源：https://gothub.org/lists.html ## 邮件列表 ### 托管在 lists\.gothub\.org 上的邮件列表 我们在我们的 lists\.gothub\.org 服务器上提供无限制的托管邮件列表。托管服务作为我们任何订阅层级 (https://gothub.org/tiers.html) 的一部分，在*公平使用*基础上提供。我们的目标是促进社区和组织内部、软件项目开发者之间，以及用户与开发者之间的沟通。可以托管公共和私人列表。我们的邮件列表基础设施与我们的 Git 托管基础设施完全分开。大多数与邮件列表管理软件的交互都通过电子邮件进行。用户通过电子邮件地址而不是 SSH 密钥进行识别。它与在 gotsys.conf (https://gameoftrees.org/gotsys.conf.5.html) 中声明的用户账户没有关联。 公共邮件列表可以存档在我们的服务器上。档案可以通过电子邮件访问。未来计划提供基于 Web 的档案访问。 ### 申请邮件列表 要申请邮件列表，请联系我们 (https://gothub.org/contact.html) 并告知我们： - 该邮件列表将关联到哪个**项目**（你的 project.gothub.org）。 - 你自己的**自定义域名**，如果你想使用自己的域名而不是 lists.gothub.org。我们将与你协调所需的 DNS 配置。 - 你想创建的列表的**地址**。当使用 lists.gothub.org 域名时，列表地址应以你的项目名称开头，以避免命名冲突。 - 邮件列表初始**所有者**和**版主**的电子邮件地址。所有者可以接受或拒绝新的订阅请求。版主可以通过或拒绝等待审核的消息。如果未指定，你发送邮件的电子邮件地址将用作初始所有者和版主。 - 为了维护我们的公平使用标准，我们希望了解你的邮件列表的**用途**。请参考下面的邮件列表类型 (https://gothub.org/lists.html#types)、使用建议 (https://gothub.org/lists.html#usage) 和申请模板 (https://gothub.org/lists.html#templates) 作为指导。 虽然我们负责基础设施，但你将主要负责管理自己的邮件列表。这包括： - 根据我们运行的邮件列表管理软件（目前是 mlmmj (https://mlmmj.org/)）所提供的功能，自行管理你的列表配置。当然，遇到问题时我们会尽力协助你。 - 确保有积极的邮件列表版主。版主需要过滤发送到列表的垃圾邮件，并在讨论期间遵守我们的服务条款 (https://gothub.org/terms.html)。 - 如果你取消订阅或停止参与一个依赖你的邮件列表进行沟通的项目，你应该通知我们 (https://gothub.org/contact.html) 并将列表移交给可以继续负责的人。没有任何订阅支持的孤立列表可能会有一个宽限期，在此期间可以安排新的订阅。 ### 邮件列表的用途 Game of Trees Hub 管理团队决定提供托管邮件列表，因为： - 我们希望让今天起步的项目或需要从即将关闭的邮件列表服务器迁移的项目能够轻松使用邮件列表。不幸的是，在当今的互联网上运行自托管的电子邮件设置**并非易事**。许多今天仍在自托管自己邮件列表的项目从 1990 年代就开始这样做了。对于尚未成为拥有自定义项目基础设施的大型基金会一部分的小型和独立软件项目，托管解决方案非常稀缺。 - 我们自己**知道如何使用**邮件列表。我们的一些管理团队成员在专业软件开发工作中使用邮件列表已有 20 多年。 - 我们自己**知道如何托管**电子邮件。我们与 OpenSMTPD (https://opensmtpd.org/) 项目关系密切，OpenSMTPD 和 Game of Trees Hub 的开发者有重叠。 - 邮件列表可以在一定程度上覆盖 Game of Trees (https://gameoftrees.org/) 尚未（可能尚未）支持的用例，而这些用例在其他 Git 托管站点上是**标准锻造功能**。这包括公共讨论论坛、代码审查、错误报告以及软件项目成员之间的私人通信渠道。 - 电子邮件从设计上就是**联合的**。几乎每个人都已经拥有一个电子邮件地址，这为想要加入公共讨论的新人提供了低门槛。大多数其他 Git 托管站点仅有限地使用电子邮件，即使几乎所有站点都在初始账户设置中使用电子邮件，因为电子邮件作为初始用户标识符的地位仍无可匹敌。一个著名的例外当然是 Sourcehut，它甚至比我们更深入地将电子邮件集成到其工作流程的核心。我们也意识到一些 Git 托管站点正在研究与 ActivityPub 的联合，这不是我们愿意在自己托管站点的设计中集成的东西。 我们理解邮件列表可能并非今天每个人的完美工具。邮件列表有其缺点：补丁可能会损坏，没有可见头像和面孔的纯文本通信可能会令人尴尬，垃圾邮件也可能成为问题。某些电子邮件客户端使邮件列表比其他客户端更易于使用。 邮件列表的优点是：固有的异步工作流程（实时通知是例外而非常态）、避免客户端和服务端供应商锁定、对资源要求低、与网络相比软件复杂度相对较低，以及灵活的客户端用户界面。其他人将只能通过你所写的内容来感知你 (https://producingoss.com/en/you-are-what-you-write.html) 这一事实可能令人尴尬，但有时也同样是一种福气。并非每次会议都需要是视频通话。 如果你对如何在项目中最佳使用邮件列表有疑问，请随时联系我们 (https://gothub.org/contact.html)。 ### 邮件列表类型 我们使用的邮件列表软件（目前是 mlmmj (https://mlmmj.org/)）提供许多配置选项，需要根据邮件列表的用途进行设置。为了更容易入门，我们定义了几种你可以选择的邮件列表类型：**公共**、**公共只读**、**私人**和**机密**。如果没有我们的预定义类型符合你的需求，请联系我们 (https://gothub.org/contact.html)。 - 所有类型列表的一般行为： - 传入消息的默认大小限制为 4MB。 - 当有人（取消）订阅时，列表所有者会收到通知。 - **公共**邮件列表的行为（例如 dev@, users@, community@, bugs@）： - 订阅*不受*审核。 - 只有订阅者可以发帖。避免垃圾邮件。 - 任何人，包括非订阅者，都可以获取电子邮件存档。 - 发送者将收到他们所发消息的副本。 - **公共只读**邮件列表的行为（例如 announce@, commits@, notifications@）： - 订阅*不受*审核。 - 只有版主和选定的电子邮件地址可以发帖。 - **私人**邮件列表的行为（例如 private@, admins@）： - 订阅需要审核。 - 只有订阅者可以发帖。 - 发送者将收到他们所发消息的副本。 - 邮件列表存档被禁用，因为我们不想在服务器上存储私人电子邮件。 - **机密**邮件列表的行为（例如 security@）： - 订阅需要审核。 - 版主必须手动接受所有消息。 - 发送者*不会*收到他们所发消息的副本。 - 邮件列表存档被禁用，因为我们不想在服务器上存储机密电子邮件。 ### 使用建议 如果你不确定邮件列表如何用于你的项目，我们根据开源和自由软件项目中邮件列表的传统使用方式，在下方提供了一些想法。我们还建议阅读 Karl Fogel 的著作《制作开源软件》(Producing Open Source Software) (https://producingoss.com/) 中的“消息论坛 / 邮件列表”(Message Forums / Mailing Lists) (https://producingoss.com/en/message-forums.html) 章节以获得额外指导。 - 一个**社区**邮件列表可用于社区内部的普遍讨论。即使其目的与软件开发无关，我们也可以托管此类邮件列表。此类列表可用于共享特定兴趣的人群、朋友、家人、俱乐部或组织成员等之间的讨论。此类列表可以是公共的（对任何人开放订阅）或私人的（新订阅需要批准）。 - 一个**公告**邮件列表可用于发布关于你项目的消息。此类列表通常消息量很少，每月最多几条消息，很像博客。向此列表发布消息的作者通常是项目的代表。此类列表的订阅者通常只阅读发布的信息，不会向列表发送反馈。反馈可以通过其他渠道收集，例如另一个邮件列表。 - 一个**开发**邮件列表可用于开发讨论和代码审查。我们建议仅向此类列表发送纯文本电子邮件（非 HTML），必要时可附带非文本文件的附件。补丁可以内联作为消息文本的一部分发送，或作为附件发送。我们建议避免顶置回复（在原始消息上方书写回复）。相反，对原始消息特定部分的响应应出现在引用被回复部分的文本块下方。这在审查补丁时尤其重要，但也有助于保持普遍讨论线程的专注和组织。 - 一个**用户**邮件列表通常用于软件项目用户之间的公共讨论。开发人员也可能参与并回复，例如在问题未解决时提供专业知识。然而，用户通常可以很好地相互支持。请注意，此类列表的公共性质和松散的技术焦点可能需要比其他类型的列表付出更多的审核努力。 - 一个**私人**邮件列表通常用于项目开发者之间的私人通信。通信是私密的，这意味着只有选定的收件人才能在他们的电子邮件收件箱中找到这些消息。也可以用 PGP 加密消息，但在实践中很少为小组讨论这样做。如果你的项目需要讨论无法负责任地公开讨论的事项，例如提议新的项目提交访问权限候选人，或组织可能泄露人员出行路线信息的活动，那么私人邮件列表可能很适合这个目的。 - 一个**安全**邮件列表通常用于收集标识安全问题的错误报告。此类列表的主要目的是为安全研究人员提供一个专用的联系点，他们期望在安全问题向公众披露之前与项目进行私人交谈。此类列表通常是私有的，这意味着只有选定的收件人才能阅读发送给他们的消息。也可以有一个公共的 PGP 密钥，供安全研究人员用于加密发送到列表的消息，确保有关安全问题的信息在传输过程中不会泄露。如果你的项目打算支持那些在生产环境中依赖你软件的人，那么应该有一个明显供安全研究人员联系的点，而安全邮件列表非常适合这项任务。另一方面，没有安全联系地址表明你的项目不提供安全问题支持，如果你不想或无法支持其他人的生产部署，这可能是一个你希望传递的信号。这样的工作不应该是任何人在业余时间承担的负担，尤其是对于商业性质的生产部署。 - 一个**错误**邮件列表通常用于收集普遍的错误报告。诸如 sendbug (https://man.openbsd.org/sendbug) 之类的工具可以以结构化的文本格式发送错误报告。邮件列表并不擅长跟踪问题从分诊到最终解决的状态。错误的讨论自然也会在其他类型的列表上发生，例如用户列表或安全列表。只有在没有更好的替代方案可用时，才建议使用专门的错误邮件列表，并应辅以外部对报告问题状态的跟踪。 - 一个**提交**邮件列表通常用于提交通过电子邮件 (https://www.gameoftrees.org/gotsys.conf.5.html#email) 发送的**提交通知**。此类列表允许订阅者实时获取有关软件项目更改的通知。订阅者很少（如果有的话）会手动向此列表发送消息。 ### 邮件列表申请模板 **示例 1：公共用户列表** ``` From: 你自己 To: Gothub 管理员 (见此处) Subject: 申请新的公共邮件列表 你好， 我想为我的项目申请一个公共邮件列表，用于用户提问和普遍讨论。 我的项目是：example.gothub.org 列表名称应为：[email protected] 我将成为列表所有者。请将 [email protected] 和 [email protected] 添加为版主。 此致， 你自己 ``` **示例 2：私人项目列表** ``` From: 你自己 To: Gothub 管理员 (见此处) Subject: 申请新的私人邮件列表 你好， 我想为我的项目申请一个私人邮件列表。我们将在此列表上讨论机密事项，如活动组织和安全问题。 我的项目是：example.gothub.org 我的自定义域名是：myproject.example.com 列表名称应为：[email protected] 此列表的所有者应为 [email protected], [email protected], 和 [email protected]。 此致， 你自己 ```