从 MDN 导入文档

由于 MDN 不应用于记录 mozilla-central 特定的代码或流程，因此应将文档迁移到此存储库中。

元 Bug 是 Bug 1617963。

幸运的是，有一种简单的方法可以使用 GitHub 将 MDN 中的文档导入到 Firefox 源码文档中。

  1. 安装 https://pandoc.org/ - 如果您使用的是发行版提供的软件包，请确保版本不要太旧。

  2. 确定您的页面在 GitHub 存储库中的位置 ( https://github.com/mdn/archived-content/tree/main/files/en-us/mozilla )。获取原始 URL

  3. 以以下方式运行 pandoc

$ pandoc -t rst https://github.com/mdn/archived-content/tree/main/files/en-us/mozilla/firefox/performance_best_practices_for_firefox_fe_engineers > doc.rst

  1. 在新的 doc.rst 中，识别图像并使用 wget/curl 将其下载到 img/ 目录中。

  2. 使用 ./mach lint -l rst 验证 rst 语法。

  1. 如果相关，请删除不间断空格（在 Phabricator 上用“！”呈现）

$ sed -i -e 's/\xc2\xa0/ /g' doc.rst