1 files changed, 23 insertions, 0 deletions
diff --git a/docs/code-quality/lint/linters/eslint-plugin-mozilla/prefer-formatValues.rst b/docs/code-quality/lint/linters/eslint-plugin-mozilla/prefer-formatValues.rst
new file mode 100644
index 0000000000..88eedee792
--- /dev/null
+++ b/docs/code-quality/lint/linters/eslint-plugin-mozilla/prefer-formatValues.rst
@@ -0,0 +1,23 @@
+prefer-formatValues
+===================
+
+Rejects multiple calls to document.l10n.formatValue in the same code block, to
+reduce localization overheads.
+
+Examples of incorrect code for this rule:
+-----------------------------------------
+
+.. code-block:: js
+
+    {
+      document.l10n.formatValue('foobar');
+      document.l10n.formatValue('foobaz');
+    }
+
+Examples of correct code for this rule:
+---------------------------------------
+
+.. code-block:: js
+
+    document.l10n.formatValue('foobar');
+    document.l10n.formatValues(['foobar', 'foobaz']);