如何为 Ubuntu 官方文档报告错误或参与贡献?

发现 Ubuntu 官方文档有错，或者想参与文档维护，官方给出的入口主要有两个：报告错误走 bug 提交，参与贡献走 Ubuntu Documentation Team 的 wiki 页面。文档本身以自由许可证发布，具体条款在 Legal 页面，因此贡献和再使用都有明确的授权基础。另外，服务器文档的源码已经迁移到 GitHub，涉及服务器指南的维护可以从那里入手。

报告文档错误

官方文档页面明确说明：要报告文档中的错误，应提交一个 bug（file a bug）。这是官方指定的错误反馈渠道，而不是直接在文档页面留言或发邮件。

实际操作时注意两点：

  • 先确认问题确实出在文档本身，比如命令写错、步骤缺失、链接失效，而不是你的系统环境或操作差异。
  • 提交时尽量带上出错的页面地址、你看到的原文、期望的正确内容，以及你的 Ubuntu 版本（如 24.04 LTS、26.04 LTS）。版本信息很关键，因为不同版本的文档是分开维护的。

参与贡献

官方文档由 Ubuntu Documentation Project 开发和维护。想参与贡献，入口是 Ubuntu Documentation Team 的 wiki 页面，那里会说明贡献方式和流程。

需要注意文档的维护状态正在变化：

文档类型 当前状态
服务器指南 源码已迁移到 GitHub，可参与相关维护
桌面指南 正在迁移到 Ubuntu Desktop documentation，方式与服务器指南类似
服务器指南语言 仅提供英文
桌面指南语言 提供多种语言，按浏览器首选语言显示，无对应语言时回退英文

因此，如果你打算贡献，先确认目标文档当前由哪个仓库或项目维护，再按对应渠道提交，避免把改动发到已经迁移的旧位置。

授权与再使用

文档材料以自由许可证发布，具体条款见 Legal 页面。这意味着在遵守该许可证的前提下，可以再使用和分发文档内容。贡献前建议先读一遍 Legal 页面，明确授权要求。

版本与入口提醒

官方文档按版本组织，目前列出的是受支持的 LTS 版本：

  • Ubuntu 26.04 LTS（Resolute Raccoon）：桌面版 HTML、HTML 和 PDF；服务器版 HTML、HTML 和 PDF
  • Ubuntu 24.04 LTS（Noble Numbat）：同上
  • Ubuntu 22.04 LTS（Jammy Jellyfish）：同上

不受支持的版本不会显示在列表中。如果你在旧版本上遇到问题，官方建议先参考升级到受支持版本的说明。此外，MAAS、Juju、Cloud-init 等更多 Ubuntu 文档在另一处单独提供。

help.ubuntu.com