@cloudcannon/configuration-types 0.0.48 → 0.0.50

package/dist/cloudcannon-editables.schema.json

@@ -1,29 +1,42 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Editables",
+  "description": "Configuration for editable regions in the Visual Editor, including content, block, link, image, and text editing options.",
   "$id": "https://github.com/cloudcannon/configuration-types/releases/latest/download/cloudcannon-editables.schema.json",
-  "type": "object",
-  "properties": {
-    "content": {
-      "$ref": "#/definitions/ContentEditable"
-    },
-    "block": {
-      "$ref": "#/definitions/BlockEditable"
-    },
-    "link": {
-      "$ref": "#/definitions/LinkEditable"
-    },
-    "image": {
-      "$ref": "#/definitions/ImageEditable"
-    },
-    "text": {
-      "$ref": "#/definitions/TextEditable"
+  "allOf": [
+    {
+      "$ref": "#/definitions/type._editables"
     }
-  },
-  "additionalProperties": false,
+  ],
   "definitions": {
+    "type._editables": {
+      "title": "Editables",
+      "description": "This key defines which Rich Text editors have custom configuration for the associated WYSIWYG toolbar.\n\nFor more information, please read our documentation on [Rich Text editors](https://cloudcannon.com/documentation/articles/what-are-rich-text-editors/).\n\n## Examples\n\nIn this example, we have configured the Snippet tool for WYSIWYG toolbars in the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    _editables:\n      content:\n        snippet: true\n```",
+      "type": "object",
+      "properties": {
+        "content": {
+          "$ref": "#/definitions/ContentEditable"
+        },
+        "block": {
+          "$ref": "#/definitions/BlockEditable"
+        },
+        "link": {
+          "$ref": "#/definitions/LinkEditable"
+        },
+        "image": {
+          "$ref": "#/definitions/ImageEditable"
+        },
+        "text": {
+          "$ref": "#/definitions/TextEditable"
+        }
+      },
+      "additionalProperties": false,
+      "documented": true,
+      "markdownDescription": "This key defines which Rich Text editors have custom configuration for the associated WYSIWYG toolbar.\n\nFor more information, please read our documentation on [Rich Text editors](https://cloudcannon.com/documentation/articles/what-are-rich-text-editors/).\n\n## Examples\n\nIn this example, we have configured the Snippet tool for WYSIWYG toolbars in the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    _editables:\n      content:\n        snippet: true\n```"
+    },
     "ContentEditable": {
       "title": "Content Editable",
-      "description": "Contains input options for the Content Editor.",
+      "description": "This key defines input options for the Content Editor.",
       "type": "object",
       "properties": {
         "mime_type": {
@@ -58,7 +71,9 @@
             {
               "$ref": "#/definitions/type.paths"
             }
-          ]
+          ],
+          "documented": false,
+          "title": "paths"
         },
         "bold": {
           "$ref": "#/definitions/type._editables.*.bold"
@@ -164,22 +179,24 @@
         }
       },
       "additionalProperties": false,
-      "markdownDescription": "Contains input options for the Content Editor."
+      "documented": true,
+      "markdownDescription": "This key defines input options for the Content Editor."
     },
     "type._inputs.*.options.mime_type": {
       "title": "Mime Type",
-      "description": "Sets the format images are converted to prior to upload. The extension of the file is updated to match. Defaults to keeping the mime type of the uploaded file.",
+      "description": "This key defines what format an image is converted to prior to upload.\n\n## Examples\n\nIn this example, we have configured an *Image Input* to convert images to WebP format prior to upload.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      mime_type: image/webp\n```",
       "type": "string",
       "enum": [
         "image/jpeg",
         "image/png",
         "image/webp"
       ],
-      "markdownDescription": "Sets the format images are converted to prior to upload. The extension of the file is updated to match. Defaults to keeping the mime type of the uploaded file."
+      "documented": true,
+      "markdownDescription": "This key defines what format an image is converted to prior to upload.\n\n## Examples\n\nIn this example, we have configured an *Image Input* to convert images to WebP format prior to upload.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      mime_type: image/webp\n```"
     },
     "type._inputs.*.options.resize_style": {
       "title": "Resize Style",
-      "description": "Sets how uploaded image files are resized with a bounding box defined by width and height prior to upload. Has no effect when selecting existing images, or if width and height are unset.",
+      "description": "This key defines how image files are resized prior to upload, using a bounding box defined by `width` and `height` options.\n\nValid values are `cover`, `contain`, `crop`, or `stretch`:\n\n* `cover` keeps aspect ratio and ensures the image covers the bounding box\n* `contain` keeps aspect ratio and ensures the image fits inside the bounding box\n* `crop` prompts the user with and interface to select an aspect-ratio-respecting area\n* `stretch` ignores aspect ratio and resizes the image to the bounding box\n\nThis key does not apply to existing images, and does not work if `width` and `height` options are not defined.\n\n## Examples\n\nIn this example, we have configured an *Image Input* to resize images using the `cover` style to ensure images cover the bounding box while maintaining aspect ratio.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      width: 1200\n      height: 600\n      resize_style: cover\n```",
       "default": "contain",
       "type": "string",
       "enum": [
@@ -188,74 +205,94 @@
         "stretch",
         "crop"
       ],
-      "markdownDescription": "Sets how uploaded image files are resized with a bounding box defined by width and height prior to upload. Has no effect when selecting existing images, or if width and height are unset."
+      "documented": true,
+      "markdownDescription": "This key defines how image files are resized prior to upload, using a bounding box defined by `width` and `height` options.\n\nValid values are `cover`, `contain`, `crop`, or `stretch`:\n\n* `cover` keeps aspect ratio and ensures the image covers the bounding box\n* `contain` keeps aspect ratio and ensures the image fits inside the bounding box\n* `crop` prompts the user with and interface to select an aspect-ratio-respecting area\n* `stretch` ignores aspect ratio and resizes the image to the bounding box\n\nThis key does not apply to existing images, and does not work if `width` and `height` options are not defined.\n\n## Examples\n\nIn this example, we have configured an *Image Input* to resize images using the `cover` style to ensure images cover the bounding box while maintaining aspect ratio.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      width: 1200\n      height: 600\n      resize_style: cover\n```"
     },
     "type._inputs.*.options.width": {
       "title": "Width",
-      "description": "Defines the width of the bounding box used in the image resizing process defined with resize_style.",
+      "description": "This key defines the width of the bounding box used in the resizing method defined by `resize_style`.",
       "type": "number",
-      "markdownDescription": "Defines the width of the bounding box used in the image resizing process defined with resize_style."
+      "documented": true,
+      "markdownDescription": "This key defines the width of the bounding box used in the resizing method defined by `resize_style`."
     },
     "type._inputs.*.options.height": {
       "title": "Height",
-      "description": "Defines the height of the bounding box used in the image resizing process defined with resize_style.",
+      "description": "This key defines the height of the bounding box used in the resizing method defined by `resize_style`.\n\n## Examples\n\nIn this example, we have configured the height of the bounding box for an *Image Input*.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      width: 1200\n      height: 600\n      resize_style: cover\n```",
       "type": "number",
-      "markdownDescription": "Defines the height of the bounding box used in the image resizing process defined with resize_style."
+      "documented": true,
+      "markdownDescription": "This key defines the height of the bounding box used in the resizing method defined by `resize_style`.\n\n## Examples\n\nIn this example, we have configured the height of the bounding box for an *Image Input*.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      width: 1200\n      height: 600\n      resize_style: cover\n```"
     },
     "type._inputs.*.options.expandable": {
       "title": "Expandable",
-      "description": "Controls whether or not images can be upscaled to fit the bounding box during resize prior to upload. Has no effect if files are not resized.",
+      "description": "This key defines whether you can upscale an image to fit the bounding box while resizing an image prior to upload.\n\nHas no effect if files are not resized.\n\n## Examples\n\nIn this example, we have configured an *Image Input* to allow upscaling images to fit the bounding box while resizing.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      width: 1200\n      height: 600\n      resize_style: cover\n      expandable: true\n```",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Controls whether or not images can be upscaled to fit the bounding box during resize prior to upload. Has no effect if files are not resized."
+      "documented": true,
+      "markdownDescription": "This key defines whether you can upscale an image to fit the bounding box while resizing an image prior to upload.\n\nHas no effect if files are not resized.\n\n## Examples\n\nIn this example, we have configured an *Image Input* to allow upscaling images to fit the bounding box while resizing.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      width: 1200\n      height: 600\n      resize_style: cover\n      expandable: true\n```"
     },
     "type._inputs.*.options.image_size_attributes": {
       "title": "Image Size Attributes",
-      "description": "Instructs the editor to save `width` and `height` attributes on the image elements. This can prevent pop-in as a page loads.",
+      "description": "This key toggles whether CloudCannon will instruct a rich text editor to save `width` and `height` attributes on image elements.\n\nSetting this key to `true` will instruct the rich text editor to save `width` and `height` attributes on image elements. This can prevent pop-in as a page loads.\n\nBy default, this key is `false` (i.e., width and height attributes are not saved on image elements). This defaults to `true` if the [Image Size Attributes site flag](https://cloudcannon.com/documentation/articles/legacy-option-flags/#image-size-attributes-default-behaviour) is enabled (this is enabled for sites created before June 23 2023, in order to keep those sites working).\n\n## Examples\n\nIn this example, CloudCannon will save width and height attributes on image elements in a *Rich Text Input*.\n\n```yaml\n_inputs:\n  content:\n    type: markdown\n    options:\n      image_size_attributes: true\n```",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Instructs the editor to save `width` and `height` attributes on the image elements. This can prevent pop-in as a page loads."
+      "documented": true,
+      "markdownDescription": "This key toggles whether CloudCannon will instruct a rich text editor to save `width` and `height` attributes on image elements.\n\nSetting this key to `true` will instruct the rich text editor to save `width` and `height` attributes on image elements. This can prevent pop-in as a page loads.\n\nBy default, this key is `false` (i.e., width and height attributes are not saved on image elements). This defaults to `true` if the [Image Size Attributes site flag](https://cloudcannon.com/documentation/articles/legacy-option-flags/#image-size-attributes-default-behaviour) is enabled (this is enabled for sites created before June 23 2023, in order to keep those sites working).\n\n## Examples\n\nIn this example, CloudCannon will save width and height attributes on image elements in a *Rich Text Input*.\n\n```yaml\n_inputs:\n  content:\n    type: markdown\n    options:\n      image_size_attributes: true\n```"
     },
     "type._inputs.*.options.allowed_sources": {
       "title": "Allowed Sources",
-      "description": "If you have one or more DAMs connected to your site, you can use this key to list which asset sources can be uploaded to and selected from.",
+      "description": "This key defines which sources and DAMs you are allowed to upload to and browse.\n\nThe value can be an array of strings. Valid values include `site-files` and the reference key for any DAM connected to your site.\n\nIf `site-files` is omitted from the array, site files will not be available as an asset source for this input.\n\n## Examples\n\nIn this example, we have configured allowed sources for an *Image Input*.\n\n```yaml\n_inputs:\n  image:\n    type: image\n    options:\n      allowed_sources:\n        - site-files\n        - my-cloudinary-dam\n```",
       "type": "array",
       "items": {
-        "type": "string"
+        "type": "string",
+        "documented": true,
+        "title": "allowed_sources[*]",
+        "description": "This key defines which sources and DAMs you are allowed to upload to and browse.\n\nThe value can be an array of strings. Valid values include `site-files` and the reference key for any DAM connected to your site.\n\nIf `site-files` is omitted from the array, site files will not be available as an asset source for this input.\n\n## Examples\n\nIn this example, we have configured allowed sources for an *Image Input*.\n\n```yaml\n_inputs:\n  image:\n    type: image\n    options:\n      allowed_sources:\n        - site-files\n        - my-cloudinary-dam\n```",
+        "markdownDescription": "This key defines which sources and DAMs you are allowed to upload to and browse.\n\nThe value can be an array of strings. Valid values include `site-files` and the reference key for any DAM connected to your site.\n\nIf `site-files` is omitted from the array, site files will not be available as an asset source for this input.\n\n## Examples\n\nIn this example, we have configured allowed sources for an *Image Input*.\n\n```yaml\n_inputs:\n  image:\n    type: image\n    options:\n      allowed_sources:\n        - site-files\n        - my-cloudinary-dam\n```"
       },
-      "markdownDescription": "If you have one or more DAMs connected to your site, you can use this key to list which asset sources can be uploaded to and selected from."
+      "documented": true,
+      "markdownDescription": "This key defines which sources and DAMs you are allowed to upload to and browse.\n\nThe value can be an array of strings. Valid values include `site-files` and the reference key for any DAM connected to your site.\n\nIf `site-files` is omitted from the array, site files will not be available as an asset source for this input.\n\n## Examples\n\nIn this example, we have configured allowed sources for an *Image Input*.\n\n```yaml\n_inputs:\n  image:\n    type: image\n    options:\n      allowed_sources:\n        - site-files\n        - my-cloudinary-dam\n```"
     },
     "type._inputs.*.options.prevent_resize_existing_files": {
       "title": "Prevent Resize Existing Files",
-      "description": "Enable to skip the image resizing process configured for this input when selecting existing images.",
+      "description": "This key toggles whether CloudCannon will skip the image resizing process configured for this input when selecting existing images.\n\nSetting this key to `true` will skip the image resizing process when selecting existing images.\n\n## Examples\n\nIn this example, CloudCannon will skip the image resizing process when selecting existing images for an *Image Input*.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      width: 1200\n      height: 600\n      resize_style: cover\n      prevent_resize_existing_files: true\n```",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enable to skip the image resizing process configured for this input when selecting existing images."
+      "documented": true,
+      "markdownDescription": "This key toggles whether CloudCannon will skip the image resizing process configured for this input when selecting existing images.\n\nSetting this key to `true` will skip the image resizing process when selecting existing images.\n\n## Examples\n\nIn this example, CloudCannon will skip the image resizing process when selecting existing images for an *Image Input*.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      width: 1200\n      height: 600\n      resize_style: cover\n      prevent_resize_existing_files: true\n```"
     },
     "type._inputs.*.options.sizes": {
       "title": "Sizes",
-      "description": "Definitions for creating additional images of different sizes when uploading or selecting existing files.",
+      "description": "This key defines definitions for creating additional images of different sizes when uploading or selecting existing files.\n\n## Examples\n\nIn this example, we have configured an *Image Input* to create additional images of different sizes when uploading or selecting files.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      sizes:\n        - size: 2x\n        - size: 3x\n```",
       "type": "array",
       "items": {
         "type": "object",
         "properties": {
           "size": {
-            "description": "A number suffixed with \"x\" (relative size) or \"w\" (fixed width) for setting the dimensions of the image (e.g. 2x, 3x, 100w, 360w).",
+            "description": "This key defines a number suffixed with \"x\" (relative size) or \"w\" (fixed width) for setting the dimensions of the image (e.g. 2x, 3x, 100w, 360w).\n\n## Examples\n\nIn this example, we have configured a size definition for an *Image Input* to create a 2x relative size image.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      sizes:\n        - size: 2x\n```",
             "type": "string",
-            "markdownDescription": "A number suffixed with \"x\" (relative size) or \"w\" (fixed width) for setting the dimensions of the image (e.g. 2x, 3x, 100w, 360w)."
+            "documented": true,
+            "title": "size",
+            "markdownDescription": "This key defines a number suffixed with \"x\" (relative size) or \"w\" (fixed width) for setting the dimensions of the image (e.g. 2x, 3x, 100w, 360w).\n\n## Examples\n\nIn this example, we have configured a size definition for an *Image Input* to create a 2x relative size image.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      sizes:\n        - size: 2x\n```"
           },
           "target": {
-            "description": "A reference to another input that is given the path to this additional image file.",
+            "description": "This key defines a reference to another input that is given the path to this additional image file.",
             "type": "string",
-            "markdownDescription": "A reference to another input that is given the path to this additional image file."
+            "documented": true,
+            "title": "target",
+            "markdownDescription": "This key defines a reference to another input that is given the path to this additional image file."
           }
         },
         "required": [
           "size"
         ],
-        "additionalProperties": false
+        "additionalProperties": false,
+        "documented": true,
+        "title": "sizes[*]",
+        "description": "This key represents an individual size definition in the `options.sizes` array for *Image Inputs*.\n\nThe value is an object that can contain `size` and `target` properties.\n\n## Examples\n\nIn this example, we have configured a size definition for an *Image Input*.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      sizes:\n        - size: 2x\n          target: hero_image_2x\n```",
+        "markdownDescription": "This key represents an individual size definition in the `options.sizes` array for *Image Inputs*.\n\nThe value is an object that can contain `size` and `target` properties.\n\n## Examples\n\nIn this example, we have configured a size definition for an *Image Input*.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      sizes:\n        - size: 2x\n          target: hero_image_2x\n```"
       },
-      "markdownDescription": "Definitions for creating additional images of different sizes when uploading or selecting existing files."
+      "documented": true,
+      "markdownDescription": "This key defines definitions for creating additional images of different sizes when uploading or selecting existing files.\n\n## Examples\n\nIn this example, we have configured an *Image Input* to create additional images of different sizes when uploading or selecting files.\n\n```yaml\n_inputs:\n  hero_image:\n    type: image\n    options:\n      sizes:\n        - size: 2x\n        - size: 3x\n```"
     },
     "type.paths": {
       "title": "Paths",
@@ -283,231 +320,330 @@
           "$ref": "#/definitions/paths.uploads_use_relative_path"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "documented": true,
+      "description": "This key defines paths for your Rich Text editors or File inputs.\n\nIf undefined at higher levels of the [configuration cascade](https://cloudcannon.com/documentation/articles/using-the-configuration-cascade/), `paths` will default to any\nvalues configured in the [CloudCannon configuration file](https://cloudcannon.com/documentation/articles/what-is-the-cloudcannon-configuration-file/).\n\n## Examples\n\nIn this example, we have configured paths for the `blog` Collection to set custom upload and static paths.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      uploads: /uploads/blog/\n      static: /assets/\n```",
+      "markdownDescription": "This key defines paths for your Rich Text editors or File inputs.\n\nIf undefined at higher levels of the [configuration cascade](https://cloudcannon.com/documentation/articles/using-the-configuration-cascade/), `paths` will default to any\nvalues configured in the [CloudCannon configuration file](https://cloudcannon.com/documentation/articles/what-is-the-cloudcannon-configuration-file/).\n\n## Examples\n\nIn this example, we have configured paths for the `blog` Collection to set custom upload and static paths.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      uploads: /uploads/blog/\n      static: /assets/\n```"
     },
     "paths.static": {
-      "type": "string"
+      "type": "string",
+      "documented": true,
+      "title": "static",
+      "description": "This key defines the path for the location of statically copied assets.\n\n## Examples\n\nIn this example, we have configured the static path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      static: /assets/\n```",
+      "markdownDescription": "This key defines the path for the location of statically copied assets.\n\n## Examples\n\nIn this example, we have configured the static path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      static: /assets/\n```"
     },
     "paths.uploads": {
       "default": "uploads",
-      "type": "string"
+      "type": "string",
+      "documented": true,
+      "title": "uploads",
+      "description": "This key defines the paths for the default location of newly uploaded site files.\n\nYou can use [dynamic placeholders](https://cloudcannon.com/documentation/articles/configure-your-template-strings/) for `uploads` and `dam_uploads`.\n\n## Examples\n\nIn this example, we have configured the uploads path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      uploads: /uploads/blog/\n```",
+      "markdownDescription": "This key defines the paths for the default location of newly uploaded site files.\n\nYou can use [dynamic placeholders](https://cloudcannon.com/documentation/articles/configure-your-template-strings/) for `uploads` and `dam_uploads`.\n\n## Examples\n\nIn this example, we have configured the uploads path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      uploads: /uploads/blog/\n```"
     },
     "paths.uploads_filename": {
-      "type": "string"
+      "type": "string",
+      "documented": true,
+      "title": "uploads_filename",
+      "description": "This key defines the path for the name of the uploaded file.\n\n## Examples\n\nIn this example, we have configured the uploads filename path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      uploads_filename: '{filename|slugify}'\n```",
+      "markdownDescription": "This key defines the path for the name of the uploaded file.\n\n## Examples\n\nIn this example, we have configured the uploads filename path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      uploads_filename: '{filename|slugify}'\n```"
     },
     "paths.dam_uploads": {
-      "type": "string"
+      "type": "string",
+      "documented": true,
+      "title": "dam_uploads",
+      "description": "This key defines the path for the default location of newly uploaded [DAM](https://cloudcannon.com/documentation/articles/introduction-to-assets-and-dams/)\nfiles.\n\nYou can use [dynamic placeholders](https://cloudcannon.com/documentation/articles/configure-your-template-strings/) for `uploads` and `dam_uploads`.\n\n## Examples\n\nIn this example, we have configured the DAM uploads path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      dam_uploads: /dam/uploads/blog/\n```",
+      "markdownDescription": "This key defines the path for the default location of newly uploaded [DAM](https://cloudcannon.com/documentation/articles/introduction-to-assets-and-dams/)\nfiles.\n\nYou can use [dynamic placeholders](https://cloudcannon.com/documentation/articles/configure-your-template-strings/) for `uploads` and `dam_uploads`.\n\n## Examples\n\nIn this example, we have configured the DAM uploads path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      dam_uploads: /dam/uploads/blog/\n```"
     },
     "paths.dam_uploads_filename": {
-      "type": "string"
+      "type": "string",
+      "documented": true,
+      "title": "dam_uploads_filename",
+      "description": "This key defines the path for the name of the uploaded file, when uploading [DAM](https://cloudcannon.com/documentation/articles/introduction-to-assets-and-dams/) files.\n\n## Examples\n\nIn this example, we have configured the DAM uploads filename path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      dam_uploads_filename: '{filename|slugify}'\n```",
+      "markdownDescription": "This key defines the path for the name of the uploaded file, when uploading [DAM](https://cloudcannon.com/documentation/articles/introduction-to-assets-and-dams/) files.\n\n## Examples\n\nIn this example, we have configured the DAM uploads filename path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      dam_uploads_filename: '{filename|slugify}'\n```"
     },
     "paths.dam_static": {
-      "type": "string"
+      "type": "string",
+      "documented": true,
+      "title": "dam_static",
+      "description": "This key defines the path for the location of statically copied assets for [DAM](https://cloudcannon.com/documentation/articles/introduction-to-assets-and-dams/) files.\n\n## Examples\n\nIn this example, we have configured the DAM static path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      dam_static: /assets/dam/\n```",
+      "markdownDescription": "This key defines the path for the location of statically copied assets for [DAM](https://cloudcannon.com/documentation/articles/introduction-to-assets-and-dams/) files.\n\n## Examples\n\nIn this example, we have configured the DAM static path for the `blog` Collection.\n\n```yaml\ncollections_config:\n  blog:\n    paths:\n      dam_static: /assets/dam/\n```"
     },
     "paths.uploads_use_relative_path": {
       "default": false,
-      "type": "boolean"
+      "type": "boolean",
+      "documented": true,
+      "title": "uploads_use_relative_path",
+      "description": "This key toggles whether CloudCannon will use relative paths instead of absolute paths for uploaded files.\n\nSetting this key to `true` will make CloudCannon use relative paths for uploaded files, which are relative to the file being edited rather than the repository root.\n\n## Examples\n\nIn this example, we have configured uploads to use relative paths for files uploaded in the Content Editor.\n\n```yaml\n_editables:\n  content:\n    paths:\n      uploads_use_relative_path: true\n```",
+      "markdownDescription": "This key toggles whether CloudCannon will use relative paths instead of absolute paths for uploaded files.\n\nSetting this key to `true` will make CloudCannon use relative paths for uploaded files, which are relative to the file being edited rather than the repository root.\n\n## Examples\n\nIn this example, we have configured uploads to use relative paths for files uploaded in the Content Editor.\n\n```yaml\n_editables:\n  content:\n    paths:\n      uploads_use_relative_path: true\n```"
     },
     "type._editables.*.bold": {
-      "description": "Enables a control to set selected text to bold.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to bold selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to bold selected text.",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Enables a control to set selected text to bold."
+      "documented": true,
+      "title": "bold",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to bold selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to bold selected text."
     },
     "type._editables.*.copyformatting": {
-      "description": "Enables a control to copy formatting from text to other text. Only applies to formatting from `bold`, `italic`, `underline`, `strike`, `subscript`, and `superscript`. Does not copy other styles or formatting.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to copy formatting from selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to copy formatting from selected text. Applies to `bold`, `italic`, `underline`, `strike`, `subscript`, and `superscript` formatting. Does not copy other styles or formatting.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to copy formatting from text to other text. Only applies to formatting from `bold`, `italic`, `underline`, `strike`, `subscript`, and `superscript`. Does not copy other styles or formatting."
+      "documented": true,
+      "title": "copyformatting",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to copy formatting from selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to copy formatting from selected text. Applies to `bold`, `italic`, `underline`, `strike`, `subscript`, and `superscript` formatting. Does not copy other styles or formatting."
     },
     "type._editables.*.italic": {
-      "description": "Enables a control to italicize selected text.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to italicize selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to italicize selected text.",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Enables a control to italicize selected text."
+      "documented": true,
+      "title": "italic",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to italicize selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to italicize selected text."
     },
     "type._editables.*.link": {
-      "description": "Enables a control to create hyperlinks around selected text.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to create a hyperlink around selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to create a hyperlink around selected text.",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Enables a control to create hyperlinks around selected text."
+      "documented": true,
+      "title": "link",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to create a hyperlink around selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to create a hyperlink around selected text."
     },
     "type._editables.*.redo": {
-      "description": "Enables a control to redo recent edits undone with undo. Redo is always enabled through standard OS-specific keyboard shortcuts.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to redo recent edits undone with `undo`.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to redo recent edits. Undo is always enabled through standard OS-specific keyboard shortcuts.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to redo recent edits undone with undo. Redo is always enabled through standard OS-specific keyboard shortcuts."
+      "documented": true,
+      "title": "redo",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to redo recent edits undone with `undo`.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to redo recent edits. Undo is always enabled through standard OS-specific keyboard shortcuts."
     },
     "type._editables.*.removeformat": {
-      "description": "Enables the control to remove formatting from text. Applies to formatting from `bold`, `italic`, `underline`, `strike`, `subscript`, and `superscript`. Does not remove other styles or formatting.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to remove formatting from selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to remove formatting. Applies to `bold`, `italic`, `underline`, `strike`, `subscript`, and `superscript` formatting. Does not remove other styles or formatting.",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Enables the control to remove formatting from text. Applies to formatting from `bold`, `italic`, `underline`, `strike`, `subscript`, and `superscript`. Does not remove other styles or formatting."
+      "documented": true,
+      "title": "removeformat",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to remove formatting from selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to remove formatting. Applies to `bold`, `italic`, `underline`, `strike`, `subscript`, and `superscript` formatting. Does not remove other styles or formatting."
     },
     "type._editables.*.strike": {
-      "description": "Enables a control to strike selected text.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to strike through selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to strike through selected text.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to strike selected text."
+      "documented": true,
+      "title": "strike",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to strike through selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to strike through selected text."
     },
     "type._editables.*.subscript": {
-      "description": "Enables a control to set selected text to subscript.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to subscript selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to subscript selected text.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to set selected text to subscript."
+      "documented": true,
+      "title": "subscript",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to subscript selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to subscript selected text."
     },
     "type._editables.*.superscript": {
-      "description": "Enables a control to set selected text to superscript.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to superscript selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to superscript selected text.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to set selected text to superscript."
+      "documented": true,
+      "title": "superscript",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to superscript selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to superscript selected text."
     },
     "type._editables.*.underline": {
-      "description": "Enables a control to underline selected text.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to underline selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to underline selected text.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to underline selected text."
+      "documented": true,
+      "title": "underline",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to underline selected text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to underline selected text."
     },
     "type._editables.*.undo": {
-      "description": "Enables a control to undo recent edits. Undo is always enabled through standard OS-specific keyboard shortcuts.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to undo recent edits.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to undo recent edits. Undo is always enabled through standard OS-specific keyboard shortcuts.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to undo recent edits. Undo is always enabled through standard OS-specific keyboard shortcuts."
+      "documented": true,
+      "title": "undo",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to undo recent edits.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to undo recent edits. Undo is always enabled through standard OS-specific keyboard shortcuts."
     },
     "type._editables.*.remove_custom_markup": {
-      "description": "Defines if the content should be stripped of \"custom markup\". It is recommended to have this option turned on once you have all of your rich text options configured. Having `allow_custom_markup` turned on disables this option. Defaults to false.",
+      "description": "This key toggles whether CloudCannon will allow you to strip custom markup from content edited in a rich text editor, allowing you to clean files of unnecessary HTML content.\n\nSetting this key to `true` will enable stripping custom markup from content. The `remove_custom_markup` key is disabled if `allow_custom_markup` is enabled.",
       "type": "boolean",
-      "markdownDescription": "Defines if the content should be stripped of \"custom markup\". It is recommended to have this option turned on once you have all of your rich text options configured. Having `allow_custom_markup` turned on disables this option. Defaults to false."
+      "documented": true,
+      "title": "remove_custom_markup",
+      "markdownDescription": "This key toggles whether CloudCannon will allow you to strip custom markup from content edited in a rich text editor, allowing you to clean files of unnecessary HTML content.\n\nSetting this key to `true` will enable stripping custom markup from content. The `remove_custom_markup` key is disabled if `allow_custom_markup` is enabled."
     },
     "type._editables.*.allow_custom_markup": {
-      "description": "Defines if the content can contain \"custom markup\". It is not recommended to have this option turned on. Defaults to true for non-content editable regions, false otherwise.",
+      "description": "This key toggles whether CloudCannon will allow you to edit custom markup in rich text editors and explicitly accept the risk of unintentionally deleting elements that cannot be recreated.\n\nSetting this key to `true` will enable editing of custom markup. When using `allow_custom_markup` outside of editable regions, content that uses JavaScript will not be editable for security reasons. These inputs will appear as uneditable snippets.",
       "type": "boolean",
-      "markdownDescription": "Defines if the content can contain \"custom markup\". It is not recommended to have this option turned on. Defaults to true for non-content editable regions, false otherwise."
+      "documented": true,
+      "title": "allow_custom_markup",
+      "markdownDescription": "This key toggles whether CloudCannon will allow you to edit custom markup in rich text editors and explicitly accept the risk of unintentionally deleting elements that cannot be recreated.\n\nSetting this key to `true` will enable editing of custom markup. When using `allow_custom_markup` outside of editable regions, content that uses JavaScript will not be editable for security reasons. These inputs will appear as uneditable snippets."
     },
     "type._editables.*.blockquote": {
-      "description": "Enables a control to wrap blocks of text in block quotes.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to wrap selected blocks of text in a block quote.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to wrap selected blocks of text in a block quote.",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Enables a control to wrap blocks of text in block quotes."
+      "documented": true,
+      "title": "blockquote",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to wrap selected blocks of text in a block quote.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to wrap selected blocks of text in a block quote."
     },
     "type._editables.*.bulletedlist": {
-      "description": "Enables a control to insert an unordered list, or to convert selected blocks of text into a unordered list.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert an unordered list or convert selected text to an unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert an unordered list or convert selected text to an unordered list.",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Enables a control to insert an unordered list, or to convert selected blocks of text into a unordered list."
+      "documented": true,
+      "title": "bulletedlist",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert an unordered list or convert selected text to an unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert an unordered list or convert selected text to an unordered list."
     },
     "type._editables.*.center": {
-      "description": "Enables a control to center align text by toggling a class name for a block of text. The value is the class name the editor should add to align the text. The styles for this class need to be listed in the `styles` file to take effect outside of the input.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to center align selected text by toggling a class name for that text block.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to center align selected text. The value is the class name to align the text. The styles for this class must be defined in the `styles` file.",
       "type": "string",
-      "markdownDescription": "Enables a control to center align text by toggling a class name for a block of text. The value is the class name the editor should add to align the text. The styles for this class need to be listed in the `styles` file to take effect outside of the input."
+      "documented": true,
+      "title": "center",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to center align selected text by toggling a class name for that text block.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to center align selected text. The value is the class name to align the text. The styles for this class must be defined in the `styles` file."
     },
     "type._editables.*.code_inline": {
-      "description": "Enables a control to create an inline code element, containing any selected text.",
+      "description": "This key toggles whether CloudCannon will display a control in your WYSIWYG toolbar to create an inline code element, containing any selected text.\n\nSetting this key to `true` will enable a control in your WYSIWYG toolbar to create an inline code element.\n\nBy default, this key is `false` (i.e., the inline code control is not displayed).",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to create an inline code element, containing any selected text."
+      "documented": true,
+      "title": "code_inline",
+      "markdownDescription": "This key toggles whether CloudCannon will display a control in your WYSIWYG toolbar to create an inline code element, containing any selected text.\n\nSetting this key to `true` will enable a control in your WYSIWYG toolbar to create an inline code element.\n\nBy default, this key is `false` (i.e., the inline code control is not displayed)."
     },
     "type._editables.*.code_block": {
-      "description": "Enables a control to insert a code block.",
+      "description": "This key toggles whether CloudCannon will display a control in your WYSIWYG toolbar to insert a code block in editable regions.\n\nSetting this key to `true` will enable a control in your WYSIWYG toolbar to insert a code block.\n\nBy default, this key is `false` (i.e., the code block control is not displayed).",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to insert a code block."
+      "documented": true,
+      "title": "code_block",
+      "markdownDescription": "This key toggles whether CloudCannon will display a control in your WYSIWYG toolbar to insert a code block in editable regions.\n\nSetting this key to `true` will enable a control in your WYSIWYG toolbar to insert a code block.\n\nBy default, this key is `false` (i.e., the code block control is not displayed)."
     },
     "type._editables.*.code": {
-      "description": "Enables both block and inline code controls: `code_block` and `code_inline`.",
+      "description": "This key toggles whether CloudCannon will display tools in your WYSIWYG toolbar to turn selected text into inline code and selected text into a code block.\n\nSetting this key to `true` will enable two tools in your WYSIWYG toolbar to turn selected text into inline code and selected text into a code block.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables both block and inline code controls: `code_block` and `code_inline`."
+      "documented": true,
+      "title": "code",
+      "markdownDescription": "This key toggles whether CloudCannon will display tools in your WYSIWYG toolbar to turn selected text into inline code and selected text into a code block.\n\nSetting this key to `true` will enable two tools in your WYSIWYG toolbar to turn selected text into inline code and selected text into a code block."
     },
     "type._editables.*.embed": {
-      "description": "Enables a control to insert a region of raw HTML, including YouTube, Vimeo, Tweets, and other media. Embedded content is sanitized to mitigate XSS risks, which includes removing style tags. Embeds containing script tags are not loaded in the editor.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert a region of raw HTML for YouTube, Vimeo, social media posts, or other media.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert a region of raw HTML. Embedded content is sanitized to mitigate XSS risks, which includes removing `style` tags. Embeds containing `script` tags are not loaded a rich text editor.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to insert a region of raw HTML, including YouTube, Vimeo, Tweets, and other media. Embedded content is sanitized to mitigate XSS risks, which includes removing style tags. Embeds containing script tags are not loaded in the editor."
+      "documented": true,
+      "title": "embed",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert a region of raw HTML for YouTube, Vimeo, social media posts, or other media.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert a region of raw HTML. Embedded content is sanitized to mitigate XSS risks, which includes removing `style` tags. Embeds containing `script` tags are not loaded a rich text editor."
     },
     "type._editables.*.format": {
-      "description": "Enables a drop down menu for structured text. Has options for \"p\", \"h1\", \"h2\", \"h3\", \"h4\", \"h5\", \"h6\". Set as space separated options (e.g. \"p h1 h2\").",
+      "description": "This key toggles whether CloudCannon will display a dropdown menu tool in your WYSIWYG toolbar for structured text.\n\nSetting this key to `true` will enable a dropdown menu tool in your WYSIWYG toolbar for structured text. Valid values include for `p`, `h1`, `h2`, `h3`, `h4`, `h5`, `h6`, `pre`, `address`, and `div`. Include a space between each values, e.g. `format: p h1 h2`.",
       "default": "p h1 h2 h3 h4 h5 h6",
       "type": "string",
-      "markdownDescription": "Enables a drop down menu for structured text. Has options for \"p\", \"h1\", \"h2\", \"h3\", \"h4\", \"h5\", \"h6\". Set as space separated options (e.g. \"p h1 h2\")."
+      "documented": true,
+      "title": "format",
+      "markdownDescription": "This key toggles whether CloudCannon will display a dropdown menu tool in your WYSIWYG toolbar for structured text.\n\nSetting this key to `true` will enable a dropdown menu tool in your WYSIWYG toolbar for structured text. Valid values include for `p`, `h1`, `h2`, `h3`, `h4`, `h5`, `h6`, `pre`, `address`, and `div`. Include a space between each values, e.g. `format: p h1 h2`."
     },
     "type._editables.*.horizontalrule": {
-      "description": "Enables a control to insert a horizontal rule.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert a horizontal line.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert a horizontal line.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to insert a horizontal rule."
+      "documented": true,
+      "title": "horizontalrule",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert a horizontal line.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert a horizontal line."
     },
     "type._editables.*.image": {
-      "description": "Enables a control to insert an image. The image can be uploaded, existing or an external link.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert an image and enter alternative text and title text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert an image. Select an existing image, upload an image, or use an external link.",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Enables a control to insert an image. The image can be uploaded, existing or an external link."
+      "documented": true,
+      "title": "image",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert an image and enter alternative text and title text.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert an image. Select an existing image, upload an image, or use an external link."
     },
     "type._editables.*.indent": {
-      "description": "Enables a control to increase indentation for numbered and unordered lists.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to increase the indentation of a list item in an ordered or unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to increase the indentation of a list item.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to increase indentation for numbered and unordered lists."
+      "documented": true,
+      "title": "indent",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to increase the indentation of a list item in an ordered or unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to increase the indentation of a list item."
     },
     "type._editables.*.justify": {
-      "description": "Enables a control to justify text by toggling a class name for a block of text. The value is the class name the editor should add to justify the text. The styles for this class need to be listed in the `styles` file to take effect outside of the input.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to justify selected text by toggling a class name for that text block.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to justify selected text. The value is the class name to align the text. The styles for this class must be defined in the `styles` file.",
       "type": "string",
-      "markdownDescription": "Enables a control to justify text by toggling a class name for a block of text. The value is the class name the editor should add to justify the text. The styles for this class need to be listed in the `styles` file to take effect outside of the input."
+      "documented": true,
+      "title": "justify",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to justify selected text by toggling a class name for that text block.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to justify selected text. The value is the class name to align the text. The styles for this class must be defined in the `styles` file."
     },
     "type._editables.*.left": {
-      "description": "Enables a control to left align text by toggling a class name for a block of text. The value is the class name the editor should add to align the text. The styles for this class need to be listed in the `styles` file to take effect outside of the input.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to left align selected text by toggling a class name for that text block.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to left align selected text. The value is the class name to align the text. The styles for this class must be defined in the `styles` file.",
       "type": "string",
-      "markdownDescription": "Enables a control to left align text by toggling a class name for a block of text. The value is the class name the editor should add to align the text. The styles for this class need to be listed in the `styles` file to take effect outside of the input."
+      "documented": true,
+      "title": "left",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to left align selected text by toggling a class name for that text block.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to left align selected text. The value is the class name to align the text. The styles for this class must be defined in the `styles` file."
     },
     "type._editables.*.numberedlist": {
-      "description": "Enables a control to insert a numbered list, or to convert selected blocks of text into a numbered list.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert an ordered list or convert selected text to an ordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert an ordered list or convert selected text to an ordered list.",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Enables a control to insert a numbered list, or to convert selected blocks of text into a numbered list."
+      "documented": true,
+      "title": "numberedlist",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert an ordered list or convert selected text to an ordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert an ordered list or convert selected text to an ordered list."
     },
     "type._editables.*.outdent": {
-      "description": "Enables a control to reduce indentation for numbered and unordered lists.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to decrease the indentation of a list item in an ordered or unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to decrease the indentation of a list item.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to reduce indentation for numbered and unordered lists."
+      "documented": true,
+      "title": "outdent",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to decrease the indentation of a list item in an ordered or unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to decrease the indentation of a list item."
     },
     "type._editables.*.right": {
-      "description": "Enables a control to right align text by toggling a class name for a block of text. The value is the class name the editor should add to align the text. The styles for this class need to be listed in the `styles` file to take effect outside of the input.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to right align selected text by toggling a class name for that text block.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to right align selected text. The value is the class name to align the text. The styles for this class must be defined in the `styles` file.",
       "type": "string",
-      "markdownDescription": "Enables a control to right align text by toggling a class name for a block of text. The value is the class name the editor should add to align the text. The styles for this class need to be listed in the `styles` file to take effect outside of the input."
+      "documented": true,
+      "title": "right",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to right align selected text by toggling a class name for that text block.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to right align selected text. The value is the class name to align the text. The styles for this class must be defined in the `styles` file."
     },
     "type._editables.*.snippet": {
-      "description": "Enables a control to insert snippets, if any are available.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert a [Snippet](https://cloudcannon.com/documentation/articles/what-is-a-snippet/), if any are available.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert a Snippet.",
       "default": true,
       "type": "boolean",
-      "markdownDescription": "Enables a control to insert snippets, if any are available."
+      "documented": true,
+      "title": "snippet",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert a [Snippet](https://cloudcannon.com/documentation/articles/what-is-a-snippet/), if any are available.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert a Snippet."
     },
     "type._editables.*.styles": {
-      "description": "Enables a drop down menu for editors to style selected text or blocks or text. Styles are the combination of an element and class name. The value for this option is the path (either source or build output) to the CSS file containing the styles.",
+      "description": "This key toggles whether CloudCannon will display a dropdown menu in your WYSIWYG toolbar to apply a style to selected text.\n\nSetting this key to `true` will enable a dropdown menu in your WYSIWYG toolbar to apply a style to selected text. Styles are the combination of an element and class name. The value for this option is the path (either source or build output) for the CSS file containing styles.",
       "type": "string",
-      "markdownDescription": "Enables a drop down menu for editors to style selected text or blocks or text. Styles are the combination of an element and class name. The value for this option is the path (either source or build output) to the CSS file containing the styles."
+      "documented": true,
+      "title": "styles",
+      "markdownDescription": "This key toggles whether CloudCannon will display a dropdown menu in your WYSIWYG toolbar to apply a style to selected text.\n\nSetting this key to `true` will enable a dropdown menu in your WYSIWYG toolbar to apply a style to selected text. Styles are the combination of an element and class name. The value for this option is the path (either source or build output) for the CSS file containing styles."
     },
     "type._editables.*.table": {
-      "description": "Enables a control to insert a table. Further options for table cells are available in the context menu for cells within the editor.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert a table.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert a table. Further table options are available from the table context menu in the rich text editor.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to insert a table. Further options for table cells are available in the context menu for cells within the editor."
+      "documented": true,
+      "title": "table",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to insert a table.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to insert a table. Further table options are available from the table context menu in the rich text editor."
     },
     "type._editables.*.join_above": {
-      "description": "Enables a control to join the selected block with the block above it.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to merge a list item with the item above it in an ordered or unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to merge a list item with the item above it.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to join the selected block with the block above it."
+      "documented": true,
+      "title": "join_above",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to merge a list item with the item above it in an ordered or unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to merge a list item with the item above it."
     },
     "type._editables.*.join_below": {
-      "description": "Enables a control to join the selected block with the block below it.",
+      "description": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to merge a list item with the item below it in an ordered or unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to merge a list item with the item below it.",
       "default": false,
       "type": "boolean",
-      "markdownDescription": "Enables a control to join the selected block with the block below it."
+      "documented": true,
+      "title": "join_below",
+      "markdownDescription": "This key toggles whether CloudCannon will display a tool in your WYSIWYG toolbar to merge a list item with the item below it in an ordered or unordered list.\n\nSetting this key to `true` will enable a tool in your WYSIWYG toolbar to merge a list item with the item below it."
     },
     "BlockEditable": {
       "title": "Block Editable",
-      "description": "Contains input options for block Editable Regions.",
+      "description": "This key defines input options for block Editable Regions.",
       "type": "object",
       "properties": {
         "mime_type": {
@@ -542,7 +678,9 @@
             {
               "$ref": "#/definitions/type.paths"
             }
-          ]
+          ],
+          "documented": false,
+          "title": "paths"
         },
         "bold": {
           "$ref": "#/definitions/type._editables.*.bold"
@@ -648,11 +786,12 @@
         }
       },
       "additionalProperties": false,
-      "markdownDescription": "Contains input options for block Editable Regions."
+      "documented": true,
+      "markdownDescription": "This key defines input options for block Editable Regions."
     },
     "LinkEditable": {
       "title": "Link Editable",
-      "description": "Contains input options for link Editable Regions.",
+      "description": "This key defines input options for link Editable Regions.",
       "type": "object",
       "properties": {
         "paths": {
@@ -660,15 +799,18 @@
             {
               "$ref": "#/definitions/type.paths"
             }
-          ]
+          ],
+          "documented": false,
+          "title": "paths"
         }
       },
       "additionalProperties": false,
-      "markdownDescription": "Contains input options for link Editable Regions."
+      "documented": true,
+      "markdownDescription": "This key defines input options for link Editable Regions."
     },
     "ImageEditable": {
       "title": "Image Editable",
-      "description": "Contains input options for image Editable Regions.",
+      "description": "This key defines input options for image Editable Regions.",
       "type": "object",
       "properties": {
         "mime_type": {
@@ -703,15 +845,18 @@
             {
               "$ref": "#/definitions/type.paths"
             }
-          ]
+          ],
+          "documented": false,
+          "title": "paths"
         }
       },
       "additionalProperties": false,
-      "markdownDescription": "Contains input options for image Editable Regions."
+      "documented": true,
+      "markdownDescription": "This key defines input options for image Editable Regions."
     },
     "TextEditable": {
       "title": "Text Editable",
-      "description": "Contains input options for text Editable Regions.",
+      "description": "This key defines input options for text Editable Regions.",
       "type": "object",
       "properties": {
         "paths": {
@@ -719,7 +864,9 @@
             {
               "$ref": "#/definitions/type.paths"
             }
-          ]
+          ],
+          "documented": false,
+          "title": "paths"
         },
         "bold": {
           "$ref": "#/definitions/type._editables.*.bold"
@@ -762,7 +909,10 @@
         }
       },
       "additionalProperties": false,
-      "markdownDescription": "Contains input options for text Editable Regions."
+      "documented": true,
+      "markdownDescription": "This key defines input options for text Editable Regions."
     }
-  }
+  },
+  "documented": false,
+  "markdownDescription": "Configuration for editable regions in the Visual Editor, including content, block, link, image, and text editing options."
 }