diff --git a/Design:-Palette-Management-UI.md b/Design:-Palette-Management-UI.md
index 2db774f..9277c65 100644
--- a/Design:-Palette-Management-UI.md
+++ b/Design:-Palette-Management-UI.md
@@ -61,12 +61,19 @@ By default, the catalog will be one we provide. But it needs to be possible cust
     editorTheme: {
         ...
         palette: {
-            catalogues: [ // An array of urls for catalogues
+            // An array of urls for catalogues:
+            catalogues: [ 
                   "http://catalogue.nodered.org/catalogue.json",
                   "..."
             ],
-            categories: [] // <-- supersedes existing paletteCatagories option,
-            editable: true/false // Default: true. Allows the editable palette to be disabled entirely
+
+            // Customise the order of palette categories
+            // (supersedes existing top-level paletteCategories option)
+            categories: []
+
+            // Allows the editable palette feature to be disabled entirely by setting to false.
+            // Default: true
+            editable: true/false
         }
         ...
     }