如何通过 FreeBSD Wiki 了解贡献 FreeBSD 的途径

更新时间

FreeBSD Wiki（wiki.freebsd.org）是 FreeBSD 社区的协作知识库，其中「Contributing to FreeBSD」板块集中列出了从写代码、维护 Port 到参与测试的各类贡献入口。如果你想为 FreeBSD 出力但不确定从哪里开始，可以先从该板块的 Contribution Ideas 和 JuniorJobs 页面入手，再根据兴趣转向代码、Port 或文档方向。需要说明的是，Wiki 本身是信息索引，实际贡献通常要转到对应的代码仓库、邮件列表或 Bugzilla 等平台完成。

先看贡献总入口

Wiki 首页的「Contributing to FreeBSD」区域给出了几个起点：

  • Contribution Ideas：面向新人的贡献想法清单，适合还没有明确目标的人。
  • Google Summer of Code (GSoC)：FreeBSD 参与的 GSoC 项目入口，适合学生按年度项目周期参与。
  • BecomingACommitter：说明成为 FreeBSD committer（拥有代码提交权限的开发者）的路径。
  • JuniorJobs：标注为面向新的 Base 贡献者，即适合新手入手的 base system 任务。

如果你完全没有方向，建议顺序是：先读 Contribution Ideas 找到感兴趣的方向，再看对应方向是否有 JuniorJobs 或 GSoC 项目可以承接。

按方向找具体页面

确定方向后，Wiki 把贡献路径分成了几类，每类都有对应页面：

方向 相关页面 适合谁
代码提交 BecomingACommitter、JuniorJobs 想进入 base system 开发的人
Port 维护 Maintain a FreeBSD Port、Update a FreeBSD Port 想维护或更新软件包的人
测试与集成 Testing & Continuous Integration with Jenkins、Writing tests、Coverity Source Code Analysis 关注质量与自动化的人
代码审查 Code Review with Phabricator 想参与 review 流程的人
问题跟踪 Issue Management with Bugzilla & Bugathons 想参与 bug 处理的人

其中 Port 方向还有更细的入口：Contributing to Ports: Quickstart、Ports Teams Wanted、Ports Package Manager: Rosetta Stone、Maintainer Load and Port Lifecycle Policy。如果你打算维护某个 Port，先看 Quickstart，再看 Maintainer Load and Port Lifecycle Policy 了解维护者责任。

开发工具与协作平台

Wiki 的「FreeBSD Development」板块列出了开发过程中会用到的工具页面：

  • Git Primer in the Committer's Guide 与 Git for Development：版本控制入门。
  • Issue Management with Bugzilla & Bugathons：问题跟踪与 bug 冲刺活动。
  • Code Review with Phabricator：代码审查流程。
  • Testing & Continuous Integration with Jenkins、Writing tests、Coverity Source Code Analysis：测试与静态分析。
  • Developer Tools、MentorMatch：开发工具汇总，以及为新人匹配导师的机制。

MentorMatch 对第一次贡献的人尤其有用——它把愿意带新人的开发者与需要指导的贡献者对接起来。

社区交流入口

贡献过程中遇到问题，可以通过 Wiki 列出的社区渠道求助：

  • IRC、Discord、Matrix：实时聊天。
  • Forums、mailing lists：论坛与邮件列表。
  • Mastodon via bsd.cafe、bsdnow.tv podcasts：社交媒体与播客。
  • Conferences and developer summits：会议与开发者峰会。

Wiki 首页还有「A list of all Community pages」，可以按需查找更细的社区页面。

项目与平台页面

如果你想参与具体项目，Wiki 的「FreeBSD Projects」板块区分了活跃与非活跃项目：

  • 当前活跃：LaptopDesktopWorkingGroup、Transport Protocols Working Group、Improving the Installer。
  • 已暂停或非活跃：weekly Network Status reports（页面注明 2025-07-15 起暂停）、2021 Foundation Call for Ideas。

硬件平台方面，除 amd64 外，Wiki 还列出了 ARM / arm64、PowerPC / PowerPC64、RISC-V 以及 Specific Platforms 页面，适合关注特定架构的人。

开始之前

Wiki 本身有「About this Wiki」「How To Create an Account」「Wiki Editing Guidelines」等页面，说明如何注册账号和编辑 Wiki 页面。如果你只是想贡献代码或 Port，注册 Wiki 账号并非必需，但阅读这些页面能帮你理解 Wiki 的协作方式。实际动手前，建议先确认目标方向对应的官方流程页面（如 Committer's Guide、Ports 相关文档），因为 Wiki 主要起索引和说明作用，具体操作规范以对应项目文档为准。