1 files changed, 29 insertions, 0 deletions
diff --git a/docs/code-quality/lint/linters/eslint-plugin-mozilla/reject-global-this.rst b/docs/code-quality/lint/linters/eslint-plugin-mozilla/reject-global-this.rst
new file mode 100644
index 0000000000..b3d94321f5
--- /dev/null
+++ b/docs/code-quality/lint/linters/eslint-plugin-mozilla/reject-global-this.rst
@@ -0,0 +1,29 @@
+reject-global-this
+======================
+
+Rejects global ``this`` usage in JSM files.  The global ``this`` is not
+available in ESM, and this is a preparation for the migration.
+
+Examples of incorrect code for this rule:
+-----------------------------------------
+
+.. code-block:: js
+
+    this.EXPORTED_SYMBOLS = ["foo"];
+
+    XPCOMUtils.defineLazyModuleGetters(this, {
+      AddonManager: "resource://gre/modules/AddonManager.jsm",
+    });
+
+
+Examples of correct code for this rule:
+---------------------------------------
+
+.. code-block:: js
+
+    const EXPORTED_SYMBOLS = ["foo"];
+
+    const lazy = {};
+    XPCOMUtils.defineLazyModuleGetters(lazy, {
+      AddonManager: "resource://gre/modules/AddonManager.jsm",
+    });