--- a/tools/docs/docs/index.rst
+++ b/tools/docs/docs/index.rst
@@ -2,17 +2,17 @@ Managing Documentation
 ======================
 
 This documentation is generated via the
 `Sphinx <http://sphinx-doc.org/>`_ tool from sources in the tree.
 
 To build the documentation, run ``mach doc``. Run
 ``mach help doc`` to see configurable options.
 
-MDN should not be used for Firefox/Gecko processes or source code
-documentation.
+This is the preferred location for all Firefox development process and
+source code documentation.
 
 .. toctree::
   :caption: Documentation
   :maxdepth: 2
   :glob:
 
   *

--- a/tools/docs/docs/mdn-import.rst
+++ b/tools/docs/docs/mdn-import.rst
@@ -1,11 +1,14 @@
 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.
+
 Fortunatelly, there is an easy way to import the doc from MDN
 to the firefox source docs.
 
 1. Install https://pandoc.org/
 
 2. Add a ``?raw=1`` add the end of the MDN URL
 
 3. Run pandoc the following way: