paint-boolean-ops: improve settings descriptions

Author: griffpatch

addons-l10n/en/paint-boolean-ops.json

@@ -1,18 +1,17 @@
 {
-  "paint-boolean-ops/shaping": "Shaping",
   "paint-boolean-ops/unite": "Unite",
-  "paint-boolean-ops/unite-desc": "Unite — merge selected shapes into one, filling all overlapping areas",
+  "paint-boolean-ops/unite-desc": "Unite merges selected shapes into one and fills all overlapping areas.",
   "paint-boolean-ops/subtract": "Subtract",
-  "paint-boolean-ops/subtract-alt": "Subtract — cut the front shape out of every selected shape beneath it (Alt: keep the cutter; Shift: subtract all fronts from back shape only)",
+  "paint-boolean-ops/subtract-alt": "Subtract cuts the front shape out of every selected shape beneath it. Hold Alt to keep the cutter, or Shift to subtract all front shapes from the back shape only.",
   "paint-boolean-ops/intersect": "Intersect",
-  "paint-boolean-ops/intersect-alt": "Intersect — keep only where shapes overlap (Alt: divide at all intersections)",
+  "paint-boolean-ops/intersect-alt": "Intersect keeps only the areas where shapes overlap. Hold Alt to divide at every intersection.",
   "paint-boolean-ops/divide": "Divide",
   "paint-boolean-ops/combine": "Combine",
-  "paint-boolean-ops/combine-desc": "Combine — merge shapes into a compound path; overlapping areas become transparent holes",
+  "paint-boolean-ops/combine-desc": "Combine joins shapes into a compound path, making overlapping areas transparent.",
   "paint-boolean-ops/release": "Release",
-  "paint-boolean-ops/release-desc": "Release — split this compound path back into separate individual shapes",
+  "paint-boolean-ops/release-desc": "Release splits this compound path back into separate shapes.",
   "paint-boolean-ops/expand": "Expand",
-  "paint-boolean-ops/expand-desc": "Expand — grows the shape outward by half its stroke width, making the fill match the visual edge of the stroke",
+  "paint-boolean-ops/expand-desc": "Expand grows the shape outward by half its outline width, moving the fill edge to where the outer edge of the outline was.",
   "paint-boolean-ops/open-path": "Open Path",
   "paint-boolean-ops/close-path": "Close Path"
 }

addons/paint-boolean-ops/addon.json

@@ -1,31 +1,36 @@
 {
   "name": "Boolean shape operations",
-  "description": "Adds a Shaping panel to the vector costume editor: Unite · Subtract · Intersect · Combine/Release · Expand",
+  "description": "Adds shape operations to the vector costume editor: Unite, Subtract, Intersect, Combine/Release, and Expand.",
   "info": [
     {
       "type": "info",
-      "text": "Unite — merge all selected shapes into one filled shape",
+      "text": "\"Unite\" merges all selected shapes into one filled shape.",
       "id": "infoUnite"
     },
     {
       "type": "info",
-      "text": "Subtract — front shape cuts a hole in every selected shape below it (Shift: cuts back shape only; Alt: keeps the cutter)",
+      "text": "\"Subtract\" uses the front shape to cut a hole through every selected shape below it. Hold Shift to cut only the back shape, or Alt to keep the cutter.",
       "id": "infoSubtract"
     },
     {
       "type": "info",
-      "text": "Intersect — keep only the overlapping areas of selected shapes (Alt: divide all into distinct regions)",
+      "text": "\"Intersect\" keeps only the areas where the selected shapes overlap. Hold Alt to divide them into separate regions.",
       "id": "infoIntersect"
     },
     {
       "type": "info",
-      "text": "Combine / Release — Combine groups shapes into a compound path where overlaps become transparent holes; Release splits it back into separate shapes",
+      "text": "\"Combine\" joins selected shapes into a compound path, making overlapping areas transparent. \"Release\" splits a compound path back into separate shapes.",
       "id": "infoCombine"
     },
     {
       "type": "info",
-      "text": "Expand — grows the shape outward by half its stroke width, making the fill match the visual edge of the stroke",
+      "text": "\"Expand\" grows each selected shape outward by half its outline width, moving the fill edge to where the outer edge of the outline was.",
       "id": "infoExpand"
+    },
+    {
+      "type": "notice",
+      "text": "The shape operation buttons may move into the \"More\" menu on smaller screens.",
+      "id": "moreMenu"
     }
   ],
   "credits": [