# Importing documentation from MDN

As MDN should not be used for documenting mozilla-central specific code or process,
the documentation should be migrated in this repository.

The meta bug is [Bug 1617963](https://bugzilla.mozilla.org/show_bug.cgi?id=migrate-from-mdn).

Fortunately, there is an easy way to import the doc from MDN using GitHub
to the firefox source docs.

1. Install <https://pandoc.org/> - If you are using packages provided by your distribution,
   make sure that the version is not too old.
2. Identify where your page is located on the GitHub repository ( <https://github.com/mdn/archived-content/tree/main/files/en-us/mozilla> ).
   Get the raw URL
3. Run pandoc the following way:

```shell
$ 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
```

4. In the new doc.rst, identify the images and wget/curl them into `img/`.
5. Verify the rst syntax using [./mach lint -l rst]
6) If relevant, remove unbreakable spaces (rendered with a "!" on Phabricator)

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

[./mach lint -l rst]: /tools/lint/linters/rstlinter.html