项目管理¶

邮件列表¶

ipxe-devel¶

仅限成员发帖¶

为了减少垃圾邮件，ipxe-devel 邮件列表被配置为：非成员发送的邮件会被暂扣，等待版主审批。

iPXE 的版主审批策略很简单：

任何明显的垃圾邮件都应直接丢弃，不采取进一步行动。不要把发件人加入自动丢弃列表。

其他所有邮件都应予以接受。应当把发件人加入自动接受列表。

目标是在最大限度减少版务负担的同时，通过列表杜绝一切垃圾邮件。

GitHub 集成¶

配置了一个名为 ipxe-devel 的 GitHub 用户，用 ipxe-devel@lists.ipxe.org 地址接收 GitHub 通知，以便 GitHub 的 pull request 最终会被转发到 ipxe-devel 邮件列表。列表被配置为自动接受发件地址匹配 ^[^@]+@reply\.github\.com$ 的邮件，避免每封来自 GitHub 的邮件都需要人工审核。

提交日志消息¶

iPXE 对提交日志消息的要求是：

消息以标题行开头，标题行由一个 [subject] 标签和一段简短的变更描述组成
[subject] 标签表示被修改的驱动或子系统。大多数情况下，可以查看被本补丁修改的文件的 git log 来推断。
简短描述应使用祈使语气（例如写 "Add PCI device IDs for Intel I218-LM"，而不是 "Added PCI device IDs for…" 或 "Adds PCI device IDs for"），且结尾不加标点。
琐碎的补丁或只是添加新功能的补丁，日志正文可以为空。
非琐碎的 bug 修复补丁应当有一段日志消息，解释问题和所选择的解决方案。
所有提交都必须包含 Signed-off-by: 行
应当注明所有为补丁相关工作做出贡献的人，包括 bug 报告者（Reported-by:）、测试者（Tested-by:）、被完全重写的补丁的原作者（Originally-implemented-by:）等等。由于许多贡献来自 IRC，可以使用（内部）nickmap 页面查询适合写入提交日志的全名和电子邮件地址。
相对于原始提交代码有过修改的补丁，应在发生修改的阶段包含 Modified-by: 行。
修复回归问题的补丁应当引用引入该回归的提交，同时给出提交 ID 和标题行。例如：Commit 8ab4b00 ("[libc] Rewrite setjmp() and longjmp()")

论坛审核与管理¶

forum.ipxe.org 论坛应按照以下流程定期审核：

进入 Mod CP > Forums & Posts > Moderation Queue，批准或删除队列中的每一个条目。如果看到同一用户发布的多个内容大同小异的帖子，保留看起来更完整的那一个。如果它们完全相同，保留最早的一个。所有看起来像垃圾邮件的主题和帖子都应删除。
务必反复检查审核队列，直到看到提示没有更多可供审核的主题或帖子。
如果你是管理员，在帖子审核完成后立即进入 Admin CP > Users & Groups > Users，再次用你的用户名/密码登录，点击表格右上方蓝色的 "Views" 按钮，选择 Potential spammers 视图。我们对"潜在垃圾用户"的定义是：已注册但从未发过任何帖子的用户。删除 Potential spammers 视图中的所有用户。如果注册的垃圾用户超过 200 个，你可能需要多次执行此操作。
最后，进入 Admin CP > Tools & Maintenance > Recount & Rebuild，点击 Recount Statistics 按钮。
进入 Admin CP > Tools & Maintenance > Logs > Statistics，在图表之后的表格顶部可以看到你删除了多少用户。
现在你已经知道如何审核和清理论坛了。在时间允许的情况下尽量经常执行。