Add more consistent use of mandatory vs required.

mdn · Aug 23, 2022 · 39bfa2b · 39bfa2b
1 parent ef231af
commit 39bfa2b
Show file tree

Hide file tree

Showing 7 changed files with 16 additions and 22 deletions.
diff --git a/webextensions/api/action.json b/webextensions/api/action.json
@@ -339,7 +339,7 @@
                 "notes": [
                   "This call is not persisted.",
                   "The <code>imageData</code> parameter is not accepted.",
-                  "The <code>path</code> parameter is required."
+                  "The <code>path</code> parameter is mandatory."
                 ]
               },
               "firefox": [

diff --git a/webextensions/api/browserAction.json b/webextensions/api/browserAction.json
@@ -687,7 +687,7 @@
                 "notes": [
                   "This call is not persisted.",
                   "The <code>imageData</code> parameter is not accepted.",
-                  "The <code>path</code> parameter is required."
+                  "The <code>path</code> parameter is mandatory."
                 ]
               },
               "firefox": [

diff --git a/webextensions/api/tabs.json b/webextensions/api/tabs.json
@@ -1336,14 +1336,14 @@
               "safari": {
                 "notes": [
                   "The default file format is 'jpeg'.",
-                  "<code>&lt;all_urls&gt;</code> permission is not required to call this."
+                  "<code>&lt;all_urls&gt;</code> permission is not mandatory."
                 ],
                 "version_added": "14"
               },
               "safari_ios": {
                 "notes": [
                   "The default file format is 'jpeg'.",
-                  "<code>&lt;all_urls&gt;</code> permission is not required to call this."
+                  "<code>&lt;all_urls&gt;</code> permission is not mandatory."
                 ],
                 "version_added": "15"
               }

diff --git a/webextensions/manifest/author.json b/webextensions/manifest/author.json
@@ -10,7 +10,7 @@
             },
             "edge": {
               "version_added": "14",
-              "notes": "This key is mandatory in Microsoft Edge."
+              "notes": "This property is mandatory."
             },
             "firefox": {
               "version_added": "52"

diff --git a/webextensions/manifest/background.json b/webextensions/manifest/background.json
@@ -59,7 +59,7 @@
               },
               "edge": {
                 "version_added": "14",
-                "notes": "The <code>persistent</code> property is mandatory."
+                "notes": "This property is mandatory."
               },
               "firefox": {
                 "version_added": "48",

diff --git a/webextensions/manifest/browser_specific_settings.json b/webextensions/manifest/browser_specific_settings.json
@@ -12,16 +12,10 @@
               "version_added": "15",
               "version_removed": "79"
             },
-            "firefox": [
-              {
-                "version_added": "48"
-              },
-              {
-                "version_added": "42",
-                "alternative_name": "applications",
-                "notes": "Mandatory before Firefox 48."
-              }
-            ],
+            "firefox": {
+              "version_added": "42",
+              "notes": "Mandatory before Firefox 48."
+            },
             "firefox_android": "mirror",
             "opera": "mirror",
             "safari": {

diff --git a/webextensions/manifest/theme.json b/webextensions/manifest/theme.json
@@ -62,8 +62,8 @@
                   "version_added": "55",
                   "version_removed": "70",
                   "notes": [
-                    "Before version 59, the RGB array form was not supported for this property.",
-                    "Before version 63, this property was mandatory.",
+                    "Before Firefox 59, the RGB array form was not supported for this property.",
+                    "Before Firefox 63, this property was mandatory.",
                     "Use <code>frame</code> instead."
                   ]
                 },
@@ -633,8 +633,8 @@
                   "version_added": "55",
                   "version_removed": "70",
                   "notes": [
-                    "Before version 59, the RGB array form was not supported for this property.",
-                    "Before version 63, this property was mandatory.",
+                    "Before Firefox 59, the RGB array form was not supported for this property.",
+                    "Before Firefox 63, this property was mandatory.",
                     "Use <code>tab_background_text</code> instead."
                   ]
                 },
@@ -990,7 +990,7 @@
               },
               "firefox": {
                 "version_added": "55",
-                "notes": "Mandatory before Firefox 60"
+                "notes": "Mandatory before Firefox 60."
               },
               "firefox_android": {
                 "version_added": true
@@ -1062,7 +1062,7 @@
                 },
                 "firefox_android": {
                   "version_added": true,
-                  "notes": "This property is required."
+                  "notes": "This property is mandatory."
                 },
                 "opera": {
                   "version_added": false