为 FreeBSD 做贡献

许多参与 FreeBSD 的人不是程序员。该项目包括文档编写者、网页设计师和支持人员。所有这些人都需要贡献的是投入时间和学习意愿。

这里列出的大多数任务可能需要大量时间投入、对 FreeBSD 内核的深入了解，或两者兼而有之。但是，也有许多有用的任务适合“周末黑客”。

FreeBSD PR 列表 显示了由 FreeBSD 用户提交的所有当前活动的故障报告和增强请求。PR 数据库包括程序员和非程序员任务。浏览打开的 PR，看看是否有任何让您感兴趣的内容。其中一些可能是非常简单的任务，只需要多一双眼睛来查看它们并确认 PR 中的修复是一个好的修复。其他的可能更复杂，或者可能根本没有包含修复程序。

从未分配给任何人的 PR 开始。如果一个 PR 被分配给其他人，但它看起来像您可以处理的事情，请给分配给它的那个人发电子邮件并询问您是否可以处理它 - 他们可能已经准备好了一个要测试的修补程序，或者您可以与他们讨论的其他想法。

端口集是一个持续进行的项目。我们希望为我们的用户提供一个易于使用、最新且高质量的第三方软件库。我们需要人们捐赠一些时间和精力来帮助我们实现这个目标。

任何人都可以参与，并且有很多不同的方法可以参与。为端口做贡献是帮助“回馈”项目的一种极佳方式。无论您是寻找持续的角色，还是寻找雨天消遣，我们都非常希望得到您的帮助！

有一些简单的方法可以让您为保持端口树最新和正常运行做出贡献

FreeBSD 志愿者项目和想法列表 也适用于愿意为 FreeBSD 项目做出贡献的人。该列表正在定期更新，并包含针对程序员和非程序员的项目，其中包含有关每个项目的的信息。

对一般技术兴趣的想法或建议应发送到 FreeBSD 技术讨论邮件列表。同样，对这类事情感兴趣（并且能够忍受大量邮件！）的人可以订阅 FreeBSD 技术讨论邮件列表。有关此列表和其他邮件列表的更多信息，请参见 FreeBSD 手册。

如果您要向 src 库提交简单的修补程序，请考虑将其作为 拉取请求 提交到项目的 GitHub 镜像。合适的提交应

更新拉取请求时，请使用强制推送而不是合并提交进行变基。更复杂的变化可以作为拉取请求提交，但如果它们太大、太笨拙、变得不活跃、需要在社区中进一步讨论，或需要大量修改，则可能会被关闭。请避免创建大型、范围广泛的清理补丁：它们太大，缺乏良好的审查所需关注。错误的补丁可能会被重定向到更合适的论坛，以便解决该补丁。

提交到端口库的拉取请求可能会或可能不会被处理，这取决于开发人员的意愿。目前，如果您遵循端口提交流程，您将获得更好的体验 为端口做出贡献.

文档团队也通过 GitHub 接受拉取请求，但尚未制定任何相关策略。

如果您发现错误或正在提交特定更改，请使用 错误提交表单 报告。尝试填写错误报告的每个字段。除非它们超过 65KB，否则请将任何补丁直接包含在报告中。如果补丁适合应用于源代码树，请在报告的摘要中添加 [PATCH]。包含补丁时，不要 使用剪切粘贴，因为剪切粘贴会将制表符转换为空格，使其无法使用。当补丁的大小远远超过 20KB 时，请考虑压缩它们（例如使用 gzip(1) 或 bzip2(1)）后再上传。

提交报告后，您应该会收到确认信息以及跟踪号。保留此跟踪号，以便您向我们提供有关问题的详细信息。

另请参阅 这篇文章，了解如何编写良好的问题报告。

文档变更由 FreeBSD 文档项目邮件列表 负责监督。请查看 FreeBSD 文档项目入门，了解完整的说明。使用与其他任何错误报告相同的方法发送提交和更改（即使是小的更改也欢迎！）

对现有源代码的添加或更改是一个比较棘手的事情，它很大程度上取决于您对 FreeBSD 开发的当前状态的落后程度。有一个名为“FreeBSD-CURRENT”的特殊正在进行的 FreeBSD 版本，它以多种方式提供给开发人员，方便他们积极地参与系统开发。见 FreeBSD 手册，了解有关获取和使用 FreeBSD-CURRENT 的更多信息。

从较旧的源代码工作不幸意味着您的更改有时可能过于过时或过于不同，难以重新集成到 FreeBSD 中。可以通过订阅 FreeBSD 公告邮件列表 和 FreeBSD-CURRENT 邮件列表 来最小化这种情况的发生概率，在这些邮件列表中，会进行关于系统当前状态的讨论。

假设您能够获得相当新的源代码来作为更改的基础，下一步是生成一组差异以发送给 FreeBSD 维护人员。这是使用 diff(1) 命令完成的。

提交补丁的首选 diff(1) 格式是由 diff -u 生成的统一输出格式。

或

将为给定的源文件或目录层次结构生成一组统一的差异。

见 diff(1)，了解更多信息。

获得一组差异后（您可以使用 patch(1) 命令对其进行测试），您应该将它们作为错误报告提交，以将其包含在 FreeBSD 中。不要 将差异直接发送到 FreeBSD 技术讨论邮件列表，否则它们将丢失！我们非常感谢您的提交（这是一个志愿者项目）；因为我们很忙，我们可能无法立即处理它，但它会保留在 PR 数据库中，直到我们处理它。在报告的摘要中包含 [PATCH] 以指示您的提交。

如果您认为合适（例如，您添加、删除或重命名了文件），请将更改打包到一个 tar 文件中。使用 shar(1) 创建的存档也欢迎。

如果您的更改具有潜在的敏感性，例如，如果您不确定版权问题是否允许进一步分发，那么您应该直接将更改发送到 [email protected]，而不是作为错误报告提交。 [email protected] 触达的范围较小，这些人主要负责 FreeBSD 的日常工作。请注意，这个团队也非常繁忙，因此您应该只在确实必要时才给他们发送邮件。

请参阅 intro(9) 和 style(9)，了解一些有关编码风格的信息。我们希望您在提交代码之前至少了解这些信息。

对于大量工作的重大贡献，或向 FreeBSD 添加重要新功能，几乎总是需要将更改作为 tar 文件发送，或者将它们上传到网站或 FTP 站点，以便其他人访问。如果您没有访问网站或 FTP 站点的权限，请在适当的 FreeBSD 邮件列表中询问是否有人可以为您托管更改。

在处理大量代码时，版权问题也必然会引起争议。FreeBSD 优先考虑 BSD 或 ISC 等自由软件许可证。有时也允许 GPLv2 等版权许可证。完整的列表可以在 核心团队许可政策 页面上找到。

我们非常乐意接受捐款，以促进 FreeBSD 项目的发展，而且在像我们这样的志愿者项目中，一点点就能产生很大的影响！硬件捐赠对扩展我们支持的外设列表也至关重要，因为我们通常没有足够的资金来购买这些东西。

本节将让您了解为什么需要维护端口，并概述端口维护人员的职责。

有一些非常好的地方可以找到需要关注的端口。

您可以使用 网页界面 搜索问题报告数据库并查看未解决的 PR。大多数端口 PR 是更新，但只需搜索和浏览摘要，您就可以找到一些有趣的内容来处理。

PortsFallout 显示从 FreeBSD 软件包构建中收集的端口问题。

发送已维护端口的更改也是可以的，但请记住，如果维护者已经在处理该问题，请向他们询问。

找到错误或问题后，收集信息、调查并修复！如果存在现有的 PR，请跟进该 PR。否则，创建一个新的 PR。您的更改将被审核，如果一切检查都通过，则会提交。

随着您的兴趣和承诺发生变化，您可能会发现您不再有时间继续您的一些（或全部）端口贡献。这没关系！如果您不再使用某个端口或由于其他原因而不再有时间或兴趣成为维护者，请告知我们。这样，我们就可以继续让其他人尝试处理端口中的现有问题，而无需等待您的回复。请记住，FreeBSD 是一个志愿者项目，因此，如果维护端口不再有趣，那么可能是时候让其他人来做这件事了！

无论如何，端口管理团队 (portmgr) 保留权利，如果您在一段时间内没有积极维护您的端口，则重置您的维护权限。（目前，此设置时间为 3 个月。）我们指的是，在这段时间内存在未解决的问题或待处理的更新尚未得到解决。

端口维护者手册 是您通往端口系统的搭车指南。请妥善保管！

编写 FreeBSD 问题报告 描述了如何最好地制定和提交 PR。2005 年提交了超过一万一千个端口 PR！遵循本文将极大地帮助我们减少处理您的 PR 所需的时间。

问题报告数据库.

FreeBSD Ports distfile 扫描器 (portscout) 可以向您显示无法获取 distfile 的端口。您可以检查自己的端口，也可以使用它来查找需要更新其 MASTER_SITES 的端口。

ports-mgmt/poudriere 是通过安装、打包和卸载的整个周期来测试端口的最彻底的方法。文档位于 poudriere GitHub 存储库。

portlint(1) 是一款应用程序，可用于验证您的端口是否符合许多重要的风格和功能指南。portlint 只是一个简单的启发式应用程序，因此您应该仅将其用作指南。如果 portlint 建议的更改似乎不合理，请参阅 端口维护者手册 或寻求建议。

FreeBSD 端口邮件列表 用于一般与端口相关的讨论。它是寻求帮助的好地方。您可以订阅或阅读和搜索列表存档。阅读 FreeBSD 端口错误邮件列表 的存档和 ports 树的 SVN 提交消息 也可能很有趣。

PortsFallout 是一个可以帮助搜索 FreeBSD 软件包故障存档 的地方。