@wix/ricos 10.110.0 → 10.112.0

package/dist/es/ricos-schema/next-schema/generated/ricos_document.jtd.json

@@ -8,14 +8,14 @@
         }
       },
       "COLOR_HEX": {
-        "description": "A color in hexadecimal RGB or RGBA format, such as `#FF0000` or `#FF000050`. Accepts shorthands like #F00 and #F005",
+        "description": "A color in hexadecimal RGB or RGBA format, for example `#FF0000` or `#FF000050`. `COLOR_HEX` accepts shorthand, for example #F00 or #F005.",
         "validation": {
           "type": "regex",
           "regex": "^#(?:[0-9A-Fa-f]{3,4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$"
         }
       },
       "NODE_ID": {
-        "description": "A unique identifier for a node. It must start with a letter and can contain only letters, numbers, hyphens, and underscores.",
+        "description": "See [Node ID](#node-ids).",
         "validation": {
           "type": "regex",
           "regex": "^[-_\\w]*$"
@@ -26,7 +26,7 @@
   "properties": {
     "nodes": {
       "metadata": {
-        "description": "An array of nodes representing content elements, such as `ParagraphNode`, `HeadingNode`, and so on."
+        "description": "Array of nodes representing content elements, such as `ParagraphNode` or `HeadingNode`."
       },
       "elements": {
         "ref": "RootNode"
@@ -37,13 +37,13 @@
     "metadata": {
       "ref": "Metadata",
       "metadata": {
-        "description": "Data about the Ricos document, such as version. This property is applicable only when using the ricos content editor and is auto-generated."
+        "description": "Information about the Ricos document itself, such as its version. Only relevant when building the Ricos document using the [Ricos playground](https:/ricos.dev), in which case it is auto-generated."
       }
     },
     "documentStyle": {
       "ref": "DocumentStyle",
       "metadata": {
-        "description": "Defines styles for nodes. For example, you can define general styling for `headerOne`, and then override some of the properties separately for a specific header."
+        "description": "Includes styling to be applied throughout the Ricos document for the specified node types. For example, you can define general styling for `headerOne`, and then override some of the properties separately for a specific header."
       }
     }
   },
@@ -77,7 +77,7 @@
     },
     "DocumentStyle": {
       "metadata": {
-        "description": "This object sets a default styling for a type of node throughout the entire Ricos Document. For example, we can set the text color for all Heading 1 nodes.\nYou can override the styling of Text nodes separately using [Decorations](#decorations).",
+        "description": "Sets a default styling for specific node types throughout the entire Ricos Document. For example, you can set the text color for all Heading 1 nodes.\nYou can override the styling of specific Text nodes separately using [decorations](#decorations).",
         "examples": [
           "document-style"
         ],
@@ -150,13 +150,13 @@
             "ref": "Decoration"
           },
           "metadata": {
-            "description": "Decorations for text nodes."
+            "description": "Text node decorations."
           }
         },
         "nodeStyle": {
           "ref": "NodeStyle",
           "metadata": {
-            "description": "Node style, such as padding. \n **Note:** This node requires the [lineSpacing](#plugins) plugin."
+            "description": "Node style, such as padding. \n **Note:** This node requires the [lineSpacing](#plugins) plugin to be enabled."
           }
         },
         "lineHeight": {
@@ -173,7 +173,7 @@
       },
       "optionalProperties": {
         "version": {
-          "type": "uint32",
+          "type": "int32",
           "metadata": {
             "description": "Ricos document version."
           }
@@ -200,7 +200,7 @@
         "textAlignment": {
           "metadata": {
             "emitEnum": "TextStyle_TextAlignment",
-            "description": "Text alignment. Possible values: <br> - `AUTO`: Text aligns itself automatically. <br> - `LEFT`: Text is aligned to the left. <br> - `RIGHT`: Text is aligned to the right. <br> - `CENTER`: Text is centered. <br> - `JUSTIFY`: Text is justified to both margins. Default: `AUTO`."
+            "description": "Text alignment. Supported values: <br> - `AUTO`: Text aligns itself automatically. <br> - `LEFT`: Text is aligned to the left. <br> - `RIGHT`: Text is aligned to the right. <br> - `CENTER`: Text is centered. <br> - `JUSTIFY`: Text is justified to both margins. <br> Default: `AUTO`."
           },
           "enum": [
             "AUTO",
@@ -236,20 +236,20 @@
       "optionalProperties": {
         "url": {
           "metadata": {
-            "description": "Absolute URL for the linked document."
+            "description": "Absolute URL to link to."
           },
           "type": "string"
         },
         "anchor": {
           "metadata": {
-            "description": "Target Node ID, where the user is redirected after clicking the anchor."
+            "description": "Target [Node ID](#node-ids) to link to."
           },
           "type": "string"
         },
         "target": {
           "metadata": {
             "emitEnum": "Link_Target",
-            "description": "The HTML `target` attribute value for the link. This property defines where the linked document opens. Possible values: <br> `SELF` - Default. Opens the linked document in the same frame as the link.<br> `BLANK` - Opens the linked document in a new browser tab or window.<br> `PARENT` - Opens the linked document in the link's parent frame.<br> `TOP` - Opens the linked document in the full body of the link's browser tab or window."
+            "description": "The HTML `target` attribute value for the link. This property defines where the link opens. <br> Supported values: <br> `SELF` - Opens the link in the same frame.<br> `BLANK` - Opens the link in a new browser tab or window.<br> `PARENT` - Opens the link in the parent frame.<br> `TOP` - Opens the link in the full body of the link's browser tab or window. <br> Default: `SELF`"
           },
           "enum": [
             "SELF",
@@ -260,7 +260,7 @@
         },
         "rel": {
           "metadata": {
-            "description": "This object specifies the relationship between the current document and the linked document."
+            "description": "Relationship between the current document and the linked document."
           },
           "ref": "Link_Rel"
         },
@@ -320,7 +320,7 @@
       "optionalProperties": {
         "url": {
           "metadata": {
-            "description": "Absolute URL for the file's source."
+            "description": "File source URL."
           },
           "type": "string"
         },
@@ -332,7 +332,7 @@
         },
         "private": {
           "metadata": {
-            "description": "Indicates whether the file's source is private. \n Default: `false`"
+            "description": "Whether the file's source is private. Learn more about private files in Wix ([SDK](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files) | [REST](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files)). \n Default: `false`"
           },
           "type": "boolean"
         }
@@ -342,7 +342,7 @@
       "properties": {
         "src": {
           "metadata": {
-            "description": "Media data source."
+            "description": "File source."
           },
           "ref": "FileSource"
         }
@@ -384,14 +384,14 @@
       "optionalProperties": {
         "width": {
           "metadata": {
-            "description": "Node width in a container when it's displayed. "
+            "description": "Node display width."
           },
           "ref": "PluginContainerData_Width"
         },
         "alignment": {
           "metadata": {
             "emitEnum": "PluginContainerData_Alignment",
-            "description": "Node alignment in its container. Possible values: \n - `CENTER` \n - `LEFT` \n - `RIGHT`"
+            "description": "Node alignment in its container."
           },
           "enum": [
             "CENTER",
@@ -410,13 +410,13 @@
         },
         "height": {
           "metadata": {
-            "description": "Node height in a container when it's displayed."
+            "description": "Node display height."
           },
           "ref": "PluginContainerData_Height"
         },
         "textWrap": {
           "metadata": {
-            "description": "Whether the text should wrap around the node when it's displayed. If `textWrap` is `false`, the node takes up the width of its container. \n Default: `true` for all node types except `DIVIDER`."
+            "description": "Whether the text should wrap around the node when it's displayed. If `textWrap` is `false`, the node fills the width of its container. \n Default: `true` for all node types except `DIVIDER`."
           },
           "type": "boolean"
         }
@@ -435,13 +435,13 @@
         },
         "description": {
           "metadata": {
-            "description": "Description displayed on top of the spoiler cover."
+            "description": "Text displayed on the spoiler cover."
           },
           "type": "string"
         },
         "buttonText": {
           "metadata": {
-            "description": "Text of a button that removes the spoiler cover."
+            "description": "Text that appears on the button that removes the spoiler cover."
           },
           "type": "string"
         }
@@ -453,7 +453,7 @@
     "PluginContainerData_Width": {
       "metadata": {
         "section": "containerdata",
-        "description": "The width of the node when it's displayed.",
+        "description": "Node display width.",
         "oneOf": {
           "properties": [
             "size",
@@ -465,7 +465,7 @@
         "size": {
           "metadata": {
             "emitEnum": "PluginContainerData_Width_Type",
-            "description": "Width size of a node in a container. Possible values: \n - `CONTENT`: The width of the container matches the content width. \n - `SMALL`: A small width. \n - `ORIGINAL`: The width of the container matches the original image width. **Note:** This value is applicable for `imageData` containers only. \n `FULL_WIDTH`: The image container takes up the full width of the screen. **Note:** This value is applicable for `imageData` containers only."
+            "description": "Width of a node in a container. Supported values: \n - `CONTENT`: Width of the container matches the content width. \n - `SMALL`: Small width. \n - `ORIGINAL`: Width of the container matches the original image width. **Note:** This value is only applicable for `imageData` containers. \n `FULL_WIDTH`: Image container takes up the full width of the screen. **Note:** This value is only applicable for `imageData` containers."
           },
           "enum": [
             "CONTENT",
@@ -486,7 +486,7 @@
       "optionalProperties": {
         "custom": {
           "metadata": {
-            "description": "A custom height value in pixels."
+            "description": "Node display height in pixels."
           },
           "type": "string"
         }
@@ -519,14 +519,14 @@
             "examples": [
               "bold"
             ],
-            "description": "Text that is styled to appear thicker and more prominent than normal text."
+            "description": "Bolds text, which makes it appear thicker and more prominent than normal text."
           },
           "properties": {},
           "optionalProperties": {
             "fontWeightValue": {
               "type": "float32",
               "metadata": {
-                "description": "Font weight. Values are from `100` to `900`."
+                "description": "Font weight."
               }
             }
           }
@@ -537,7 +537,7 @@
             "examples": [
               "italic"
             ],
-            "description": "Text that is styled to appear slanted or italicized, which is typically used for emphasis, citations, or to distinguish certain types of content."
+            "description": "Italicizes text, which makes it appear slanted or italicized. Italics are typically used for emphasis, citations, or to distinguish certain types of content."
           },
           "properties": {},
           "optionalProperties": {
@@ -555,14 +555,14 @@
             "examples": [
               "underline"
             ],
-            "description": "Text that is styled with a line underneath it."
+            "description": "Underlines text."
           },
           "properties": {},
           "optionalProperties": {
             "underlineData": {
               "type": "boolean",
               "metadata": {
-                "description": "Whether to enable the underlined text."
+                "description": "Whether to underline the text."
               }
             }
           }
@@ -576,7 +576,7 @@
             "features": [
               "SPOILER"
             ],
-            "description": "Text that is styled to appear blurred. <br> **Note:** This decoration requires the [spoiler](#plugins) plugin."
+            "description": "Blurs text. <br> **Note:** This decoration requires the [`spoiler`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
           },
           "properties": {},
           "optionalProperties": {
@@ -594,7 +594,7 @@
             "examples": [
               "anchor"
             ],
-            "description": "Clickable text in a hyperlink. Rendered in a different color, indicating that it is a link that users can click to navigate to section in the same page."
+            "description": "Makes clickable text a different color. The link navigates to another section of the same page."
           },
           "properties": {},
           "optionalProperties": {
@@ -615,7 +615,7 @@
             "features": [
               "MENTION"
             ],
-            "description": "A piece of text that mentions a specific user, often in social media platforms, forums, or content management systems. <br> **Note:** This decoration requires the [mention](#plugins) plugin."
+            "description": "Text that mentions a specific user, often in social media platforms, forums, or content management systems. <br> **Note:** This decoration requires the [`mention`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
           },
           "properties": {},
           "optionalProperties": {
@@ -636,7 +636,7 @@
             "features": [
               "LINK"
             ],
-            "description": "Clickable text in a hyperlink. This text is what users see and click on to navigate to another web page or another resource. <br> **Note:** This decoration requires the [link](#plugins) plugin."
+            "description": "Makes clickable text a different color. The link navigates to another webpage or resource. <br> **Note:** This decoration requires the [`link`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
           },
           "properties": {},
           "optionalProperties": {
@@ -657,7 +657,7 @@
             "features": [
               "COLOR_DECORATION"
             ],
-            "description": "Text that is styled using background and text colors. <br> **Note:** This decoration requires the [colorDecoration](#plugins) plugin."
+            "description": "Styles text using background and text colors. <br> **Note:** This decoration requires the [`colorDecoration`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
           },
           "properties": {},
           "optionalProperties": {
@@ -695,7 +695,7 @@
         "examples": [
           "bold"
         ],
-        "description": "Text that is styled to appear thicker and more prominent than normal text."
+        "description": "Bolds text, which makes it appear thicker and more prominent than normal text."
       },
       "properties": {
         "type": {
@@ -703,7 +703,7 @@
             "BOLD"
           ],
           "metadata": {
-            "description": "Decoration type. \n Value: `BOLD`"
+            "description": "Decoration type. \n Must be `BOLD`."
           }
         }
       },
@@ -711,7 +711,7 @@
         "fontWeightValue": {
           "type": "float32",
           "metadata": {
-            "description": "Font weight. Values are from `100` to `900`."
+            "description": "Font weight."
           }
         }
       }
@@ -722,7 +722,7 @@
         "examples": [
           "italic"
         ],
-        "description": "Text that is styled to appear slanted or italicized, which is typically used for emphasis, citations, or to distinguish certain types of content."
+        "description": "Italicizes text, which makes it appear slanted or italicized. Italics are typically used for emphasis, citations, or to distinguish certain types of content."
       },
       "properties": {
         "type": {
@@ -730,7 +730,7 @@
             "ITALIC"
           ],
           "metadata": {
-            "description": "Decoration type. \n Value: `ITALIC`"
+            "description": "Decoration type. \n Must be `ITALIC`."
           }
         }
       },
@@ -749,7 +749,7 @@
         "examples": [
           "underline"
         ],
-        "description": "Text that is styled with a line underneath it."
+        "description": "Underlines text."
       },
       "properties": {
         "type": {
@@ -757,7 +757,7 @@
             "UNDERLINE"
           ],
           "metadata": {
-            "description": "Decoration type. \n Value: `UNDERLINE`"
+            "description": "Decoration type. \nMust be `UNDERLINE`."
           }
         }
       },
@@ -765,7 +765,7 @@
         "underlineData": {
           "type": "boolean",
           "metadata": {
-            "description": "Whether to enable the underlined text."
+            "description": "Whether to underline the text."
           }
         }
       }
@@ -779,7 +779,7 @@
         "features": [
           "SPOILER"
         ],
-        "description": "Text that is styled to appear blurred. <br> **Note:** This decoration requires the [spoiler](#plugins) plugin."
+        "description": "Blurs text. <br> **Note:** This decoration requires the [`spoiler`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
       },
       "properties": {
         "type": {
@@ -787,7 +787,7 @@
             "SPOILER"
           ],
           "metadata": {
-            "description": "Decoration type. \n Value: `SPOILER`"
+            "description": "Decoration type. \n Must be `SPOILER`."
           }
         }
       },
@@ -806,7 +806,7 @@
         "examples": [
           "anchor"
         ],
-        "description": "Clickable text in a hyperlink. Rendered in a different color, indicating that it is a link that users can click to navigate to section in the same page."
+        "description": "Makes clickable text a different color. The link navigates to another section of the same page."
       },
       "properties": {
         "type": {
@@ -814,7 +814,7 @@
             "ANCHOR"
           ],
           "metadata": {
-            "description": "Decoration type. \n Value: `ANCHOR`"
+            "description": "Decoration type. \n Must be `ANCHOR`."
           }
         }
       },
@@ -836,7 +836,7 @@
         "features": [
           "MENTION"
         ],
-        "description": "A piece of text that mentions a specific user, often in social media platforms, forums, or content management systems. <br> **Note:** This decoration requires the [mention](#plugins) plugin."
+        "description": "Text that mentions a specific user, often in social media platforms, forums, or content management systems. <br> **Note:** This decoration requires the [`mention`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
       },
       "properties": {
         "type": {
@@ -844,7 +844,7 @@
             "MENTION"
           ],
           "metadata": {
-            "description": "Decoration type. \n Value: `MENTION`"
+            "description": "Decoration type. \n Must be `MENTION`."
           }
         }
       },
@@ -866,7 +866,7 @@
         "features": [
           "LINK"
         ],
-        "description": "Clickable text in a hyperlink. This text is what users see and click on to navigate to another web page or another resource. <br> **Note:** This decoration requires the [link](#plugins) plugin."
+        "description": "Makes clickable text a different color. The link navigates to another webpage or resource. <br> **Note:** This decoration requires the [`link`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
       },
       "properties": {
         "type": {
@@ -874,7 +874,7 @@
             "LINK"
           ],
           "metadata": {
-            "description": "Decoration type. \n Value: `LINK`"
+            "description": "Decoration type. \n Must be `LINK`."
           }
         }
       },
@@ -896,7 +896,7 @@
         "features": [
           "COLOR_DECORATION"
         ],
-        "description": "Text that is styled using background and text colors. <br> **Note:** This decoration requires the [colorDecoration](#plugins) plugin."
+        "description": "Styles text using background and text colors. <br> **Note:** This decoration requires the [`colorDecoration`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
       },
       "properties": {
         "type": {
@@ -931,7 +931,7 @@
             "FONT_SIZE"
           ],
           "metadata": {
-            "description": "Decoration type. \n Value: `FONT_SIZE`"
+            "description": "Decoration type. \n Must be `FONT_SIZE`."
           }
         }
       },
@@ -951,7 +951,7 @@
       "optionalProperties": {
         "anchor": {
           "metadata": {
-            "description": "Target Node ID, where the user is redirected after clicking the anchor."
+            "description": "Target Node ID to redirect to."
           },
           "type": "string"
         }
@@ -964,13 +964,13 @@
       "optionalProperties": {
         "background": {
           "metadata": {
-            "description": "Background color in a hexadecimal value."
+            "description": "Background color as a hexadecimal value."
           },
           "type": "string"
         },
         "foreground": {
           "metadata": {
-            "description": "Text color in a hexadecimal value."
+            "description": "Text color as a hexadecimal value."
           },
           "type": "string"
         }
@@ -997,13 +997,13 @@
         "name": {
           "type": "string",
           "metadata": {
-            "description": "The display name of the mentioned user."
+            "description": "Display name of the mentioned user."
           }
         },
         "slug": {
           "type": "string",
           "metadata": {
-            "description": "The username of the mentioned user, appearing after the \"@\" character."
+            "description": "Username of the mentioned user. This is th text that appears after the \"@\"."
           }
         },
         "id": {
@@ -1021,7 +1021,7 @@
       "optionalProperties": {
         "unit": {
           "metadata": {
-            "description": "Font size units. Possible values: \n - `PX`: Size in pixels.  \n - `EM`: Relative to the font size of the element (2em means 2 times the size of the current font) ",
+            "description": "Font size units.",
             "emitEnum": "FontSizeData_fontType"
           },
           "enum": [
@@ -1057,7 +1057,7 @@
         "examples": [
           "blockquote"
         ],
-        "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it is displayed as the quoted text with indentation or other styling to visually separate it from the surrounding content."
+        "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it displays as the quoted text with indentation or other styling to visually separate it from the surrounding content."
       },
       "properties": {
         "type": {
@@ -1065,7 +1065,7 @@
             "BLOCKQUOTE"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `BLOCKQUOTE`"
+            "description": "Node type. \n Must be `BLOCKQUOTE`."
           }
         },
         "nodes": {
@@ -1098,7 +1098,7 @@
         "style": {
           "ref": "NodeStyle",
           "metadata": {
-            "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+            "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
           }
         }
       }
@@ -1108,7 +1108,7 @@
         "indentation": {
           "type": "int32",
           "metadata": {
-            "description": "Blockquote margin from the left side. Possible values are from `1` to `4`. \n The indentation is measured in relative to the font size *em* units, by the following formula: **indentation * 1.5**. For example, if indentation is `2`, then margin is equal to **3em**. Therefore the margin is 3 times the size of the font."
+            "description": "Blockquote margin from the left side. \n The indentation is measured relative to the font size *em* units by a ratio of 1.5. For example, if the indentation is `2`, then the margin is equal to **3em**. Therefore the margin is 3 times the size of the font."
           }
         }
       },
@@ -1120,7 +1120,7 @@
       "metadata": {
         "section": "Caption",
         "examples": [],
-        "description": "Represents a caption container that can be attached to media elements like images. Captions support formatted text content and can be styled independently from their parent nodes."
+        "description": "Caption container to be attached to media elements, such as images. Captions support formatted text content and can be styled independently from their parent nodes."
       },
       "properties": {
         "type": {
@@ -1128,7 +1128,7 @@
             "CAPTION"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `CAPTION`"
+            "description": "Node type. \n Must be `CAPTION`."
           }
         },
         "nodes": {
@@ -1141,19 +1141,19 @@
         "id": {
           "type": "string",
           "metadata": {
-            "description": "Caption node ID. The editor generates the ID automatically. If you're using the Ricos object in an API, you have to add this ID manually, if needed."
+            "description": "Caption [node ID](#node-ids)."
           }
         },
         "style": {
           "ref": "NodeStyle",
           "metadata": {
-            "description": "Defines the caption style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+            "description": "Defines the caption styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
           }
         },
         "captionData": {
           "ref": "CaptionData",
           "metadata": {
-            "description": "Caption options node."
+            "description": "Caption options."
           }
         }
       }
@@ -1163,7 +1163,7 @@
         "textStyle": {
           "ref": "TextStyle",
           "metadata": {
-            "description": "Styling for the caption text."
+            "description": "Caption text styling."
           }
         }
       },
@@ -1181,7 +1181,7 @@
           "code-block-multi-line",
           "code-block-syntax-highlighting"
         ],
-        "description": "Used to present programming code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
+        "description": "Presents code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
       },
       "properties": {
         "type": {
@@ -1189,7 +1189,7 @@
             "CODE_BLOCK"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `CODE_BLOCK`"
+            "description": "Node type. \n VMust be `CODE_BLOCK`."
           }
         }
       },
@@ -1218,7 +1218,7 @@
         "style": {
           "ref": "NodeStyle",
           "metadata": {
-            "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+            "description": "Code block styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
           }
         }
       }
@@ -1228,7 +1228,7 @@
         "textStyle": {
           "ref": "TextStyle",
           "metadata": {
-            "description": "Defines the text style, such as alignment and line height."
+            "description": "Defines the text styling, such as alignment and line height."
           }
         }
       },
@@ -1242,7 +1242,7 @@
         "examples": [
           "headings-all-sizes"
         ],
-        "description": "Used to denote the heading or title of a section. Headings are hierarchical, with different levels indicating the relative importance of the heading in the content's structure. There are 6 levels of headings, where `1` is the highest level and `6` is the lowest."
+        "description": "Indicates a heading or title of a section. There are 6 levels of headings, with `1` being the most prominent and `6` being the least."
       },
       "properties": {
         "type": {
@@ -1250,7 +1250,7 @@
             "HEADING"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `HEADING`"
+            "description": "Node type. \n Must be `HEADING`."
           }
         }
       },
@@ -1273,7 +1273,7 @@
         "style": {
           "ref": "NodeStyle",
           "metadata": {
-            "description": "Defines the heading style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+            "description": "Heading styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
           }
         },
         "headingData": {
@@ -1289,7 +1289,7 @@
         "level": {
           "type": "int32",
           "metadata": {
-            "description": "Heading size from `1` to `6`, where `1` is the highest level and `6` is the lowest.",
+            "description": "Heading size. <br> Mi: `1` <br> Max: `6`",
             "validation": {
               "min": 1,
               "max": 6
@@ -1299,13 +1299,13 @@
         "textStyle": {
           "ref": "TextStyle",
           "metadata": {
-            "description": "Defines the heading text style, such as text alignment and line height."
+            "description": "Heading text styling, such as text alignment and line height."
           }
         },
         "indentation": {
           "type": "int32",
           "metadata": {
-            "description": "Heading margin from the left side. Possible values are from `1` to `4`. \n The indentation is measured in relative to the font size *em* units, by the following formula: **indentation * 1.5**. For example, if indentation is `2`, then margin is equal to **3em**. Therefore the margin is 3 times the size of the font."
+            "description": "Heading margin from the left side. \n The indentation is measured relative to the font size *em* units by a ratio of 1.5. For example, if the indentation is `2`, then the margin is equal to **3em**. Therefore the margin is 3 times the size of the font."
           }
         }
       },
@@ -1319,7 +1319,7 @@
         "examples": [
           "orderedList"
         ],
-        "description": "Presents a group of items in a sequentially numbered or lettered manner. Ordered lists are used to represent information that has a specific order or sequence."
+        "description": "Numbered list."
       },
       "properties": {
         "type": {
@@ -1327,7 +1327,7 @@
             "ORDERED_LIST"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `ORDERED_LIST`"
+            "description": "Node type. \n Must be `ORDERED_LIST`."
           }
         },
         "nodes": {
@@ -1369,19 +1369,19 @@
           "type": "int32",
           "metadata": {
             "deprecated": true,
-            "description": "List margin from the left side. Possible values are from `1` to `4`. \n The indentation is measured in relative to the font size *em* units, by the following formula: **indentation * 1.5**. For example, if indentation is `2`, then margin is equal to **3em**. Therefore the margin is 3 times the size of the font."
+            "description": "List margin from the left side. \n The indentation is measured relative to the font size *em* units by a ratio of 1.5. For example, if the indentation is `2`, then the margin is equal to **3em**. Therefore the margin is 3 times the size of the font."
           }
         },
         "offset": {
           "type": "int32",
           "metadata": {
-            "description": "An integer (ranging from 0 to 4) used to control the additional indentation level of an ordered or bulleted list node, beyond its original HTML-defined nesting. When offset is 0, the list node appears at its default nesting level; as the value increases from 1 to 4, the node is indented further, creating the visual impression of deeper nesting without altering the actual HTML structure."
+            "description": "Additional indentation of a list node. When offset is `0`, the list node appears at its default nesting level. Higher values cause increased indentation."
           }
         },
         "start": {
           "type": "int32",
           "metadata": {
-            "description": "An integer to start counting from for the list items, overriding the default start of 1."
+            "description": "Number at the top of the numbered list. <br> Default: `1`"
           }
         }
       },
@@ -1395,7 +1395,7 @@
         "examples": [
           "bulletedList"
         ],
-        "description": "Presents a group of items in a visually organized manner, where each item is preceded by a bullet point. Bulleted lists are commonly used to present unordered information."
+        "description": "Bulleted list."
       },
       "properties": {
         "type": {
@@ -1403,7 +1403,7 @@
             "BULLETED_LIST"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `BULLETED_LIST`"
+            "description": "Node type. \n Must be `BULLETED_LIST`."
           }
         },
         "nodes": {
@@ -1450,7 +1450,7 @@
         "offset": {
           "type": "int32",
           "metadata": {
-            "description": "An integer (ranging from 0 to 4) used to control the additional indentation level of an ordered or bulleted list node, beyond its original HTML-defined nesting. When `offset` is `0`, the list node appears at its default nesting level; as the value increases from 1 to 4, the node is indented further, creating the visual impression of deeper nesting without altering the actual HTML structure."
+            "description": "Additional indentation of a list node. When offset is `0`, the list node appears at its default nesting level. Higher values cause increased indentation."
           }
         }
       },
@@ -1475,7 +1475,7 @@
           "metadata": {
             "description": "Child nodes that the list item contains.",
             "pattern": {
-              "description": "A list item must start with a paragraph or heading, followed by any number of paragraphs, bulleted lists, or ordered lists.",
+              "description": "Must start with a paragraph or heading, followed by any number of paragraphs, bulleted lists, or ordered lists.",
               "value": "(PARAGRAPH|HEADING|IMAGE|VIDEO|GIF|GALLERY) (PARAGRAPH|BULLETED_LIST|ORDERED_LIST|HEADING|IMAGE|VIDEO|GIF|GALLERY)*"
             }
           }
@@ -1513,7 +1513,7 @@
         "PARAGRAPH": {
           "metadata": {
             "section": "Paragraph",
-            "description": "Used to structure text content, providing a clear separation between different ideas or sections of text. They are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
+            "description": "Structures text content, providing a clear separation between different ideas or sections of text. Paragraphs are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
             "examples": [
               "paragraph"
             ]
@@ -1538,7 +1538,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Paragraphs vertical padding. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Vertical padding. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "paragraphData": {
@@ -1555,7 +1555,7 @@
             "examples": [
               "headings-all-sizes"
             ],
-            "description": "Used to denote the heading or title of a section. Headings are hierarchical, with different levels indicating the relative importance of the heading in the content's structure. There are 6 levels of headings, where `1` is the highest level and `6` is the lowest."
+            "description": "Indicates a heading or title of a section. There are 6 levels of headings, with `1` being the most prominent and `6` being the least."
           },
           "properties": {},
           "optionalProperties": {
@@ -1577,7 +1577,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the heading style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Heading styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "headingData": {
@@ -1594,7 +1594,7 @@
             "examples": [
               "orderedList"
             ],
-            "description": "Presents a group of items in a sequentially numbered or lettered manner. Ordered lists are used to represent information that has a specific order or sequence."
+            "description": "Numbered list."
           },
           "properties": {
             "nodes": {
@@ -1636,7 +1636,7 @@
             "examples": [
               "bulletedList"
             ],
-            "description": "Presents a group of items in a visually organized manner, where each item is preceded by a bullet point. Bulleted lists are commonly used to present unordered information."
+            "description": "Bulleted list."
           },
           "properties": {
             "nodes": {
@@ -1682,7 +1682,7 @@
             "features": [
               "IMAGE"
             ],
-            "description": "Displays standalone pictures in a page."
+            "description": "Standalone images in a page."
           },
           "properties": {
             "imageData": {
@@ -1720,7 +1720,7 @@
             "features": [
               "VIDEO"
             ],
-            "description": "A multimedia node that is used to embed and play video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
+            "description": "Embeds and plays video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
           },
           "properties": {
             "videoData": {
@@ -1757,7 +1757,7 @@
             "features": [
               "GIF"
             ],
-            "description": "GIF images are made up of a series of frames, allowing them to display animations or short video clips without the need for additional plugins or technologies."
+            "description": "GIF images."
           },
           "properties": {
             "gifData": {
@@ -1794,7 +1794,7 @@
             "features": [
               "GALLERY"
             ],
-            "description": "A collection of images displayed together in a visually appealing and organized manner."
+            "description": "Collection of images displayed together."
           },
           "properties": {
             "galleryData": {
@@ -1827,7 +1827,7 @@
     "ParagraphNode": {
       "metadata": {
         "section": "Paragraph",
-        "description": "Used to structure text content, providing a clear separation between different ideas or sections of text. They are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
+        "description": "Structures text content, providing a clear separation between different ideas or sections of text. Paragraphs are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
         "examples": [
           "paragraph"
         ]
@@ -1838,7 +1838,7 @@
             "PARAGRAPH"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `PARAGRAPH`"
+            "description": "Node type. \n Must be `PARAGRAPH`."
           }
         }
       },
@@ -1861,7 +1861,7 @@
         "style": {
           "ref": "NodeStyle",
           "metadata": {
-            "description": "Paragraphs vertical padding. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+            "description": "Vertical padding. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
           }
         },
         "paragraphData": {
@@ -1877,20 +1877,20 @@
         "textStyle": {
           "ref": "TextStyle",
           "metadata": {
-            "description": "Styling for the paragraph text."
+            "description": "Paragraph text styling."
           }
         },
         "indentation": {
           "type": "int32",
           "metadata": {
-            "description": "Paragraph margin from the left side. Possible values are from `1` to `4`. <br>Actual indentation is equal to **indentation * 40px**."
+            "description": "Paragraph margin from the left side. \n The indentation is measured relative to 40px. For example, if the indentation is `2`, then the margin is equal to **80px**."
           }
         },
         "level": {
           "type": "int32",
           "metadata": {
             "internal": true,
-            "description": "Paragraph level for future different paragraphs"
+            "description": "Paragraph level for future different paragraphs."
           }
         }
       },
@@ -1904,7 +1904,7 @@
         "examples": [
           "text"
         ],
-        "description": "Text nodes hold the text itself (think `span` tag in HTML). The difference between `TextNode` and HTML `span` is that text nodes can't be nested and must contain non-empty string. Their appearance and behavior can be modified using [decorations](#decorations)."
+        "description": "Text nodes hold the text itself, similar to how `span` tags hold text in HTML. Text nodes can't be nested and must contain a non-empty string. Their appearance and behavior can be modified using [decorations](#decorations)."
       },
       "properties": {
         "type": {
@@ -1912,7 +1912,7 @@
             "TEXT"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `TEXT`"
+            "description": "Node type. \n Must be `TEXT`."
           }
         },
         "textData": {
@@ -1945,7 +1945,7 @@
         "text": {
           "type": "string",
           "metadata": {
-            "description": "A piece of text, possibly enhanced with additional decorations. Must not be empty.",
+            "description": "Non-empty string to display as text.",
             "validation": {
               "minLength": 1
             }
@@ -1958,7 +1958,7 @@
             "ref": "Decoration"
           },
           "metadata": {
-            "description": "Text decoration options, such as font and text color. Each type of decoration must appear at most once in this array.",
+            "description": "Array of text [decorations](#decorations). A decoration can't appear twice in the array.",
             "validation": {
               "uniqueTags": true
             }
@@ -1979,7 +1979,7 @@
         "features": [
           "APP_EMBED"
         ],
-        "description": "Similar to `LinkPreviewNode`, this node is used to embed external content preview, but from Wix business solutions. You can embed previews from the Wix Bookings, Wix Stores and Wix Events apps."
+        "description": "Embeds an external content preview from Wix business solutions. For example, you can embed previews from the Wix Bookings, Wix Stores and Wix Events apps."
       },
       "properties": {
         "type": {
@@ -1987,13 +1987,13 @@
             "APP_EMBED"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `APP_EMBED`"
+            "description": "Node type. \n Must be `APP_EMBED`."
           }
         },
         "appEmbedData": {
           "ref": "AppEmbedData",
           "metadata": {
-            "description": "Embedded Wix app details."
+            "description": "Embedded Wix app."
           }
         }
       },
@@ -2030,7 +2030,7 @@
         "PRODUCT": {
           "metadata": {
             "section": "App Embed",
-            "description": "Wix Stores app. Embeds a particular product."
+            "description": "Embedded a product from Wix Stores."
           },
           "properties": {
             "name": {
@@ -2071,7 +2071,7 @@
         "EVENT": {
           "metadata": {
             "section": "App Embed",
-            "description": "Wix Events app. Embeds a particular event."
+            "description": "Embeds an event from Wix Events."
           },
           "properties": {
             "name": {
@@ -2091,7 +2091,7 @@
             "eventData": {
               "ref": "AppEmbedData_EventData",
               "metadata": {
-                "description": "Embedded Wix Events app content."
+                "description": "Embedded event content."
               }
             },
             "image": {
@@ -2118,7 +2118,7 @@
         "BOOKING": {
           "metadata": {
             "section": "App Embed",
-            "description": "Wix Bookings app. Embeds a particular booking."
+            "description": "Embeds a booking from Wix Bookings."
           },
           "properties": {
             "name": {
@@ -2150,7 +2150,7 @@
             "bookingData": {
               "ref": "AppEmbedData_BookingData",
               "metadata": {
-                "description": "Embedded Wix Bookings app content."
+                "description": "Embedded booking content."
               }
             },
             "imageSrc": {
@@ -2167,7 +2167,7 @@
     "AppEmbedDataProduct": {
       "metadata": {
         "section": "App Embed",
-        "description": "Wix Stores app. Embeds a particular product."
+        "description": "Embedded a product from Wix Stores."
       },
       "properties": {
         "type": {
@@ -2175,7 +2175,7 @@
             "PRODUCT"
           ],
           "metadata": {
-            "description": "Which Wix App to embed. Possible values: \n - `PRODUCT`: Wix Stores app. Embeds a particular product. \n - `EVENT`: Wix Events app. Embeds a particular event. \n - `BOOKINGS`: Wix Bookings app. Embeds a particular booking."
+            "description": "Must be `PRODUCT`."
           }
         },
         "name": {
@@ -2216,13 +2216,16 @@
     "AppEmbedDataEvent": {
       "metadata": {
         "section": "App Embed",
-        "description": "Wix Events app. Embeds a particular event."
+        "description": "Embeds an event from Wix Events."
       },
       "properties": {
         "type": {
           "enum": [
             "EVENT"
-          ]
+          ],
+          "metadata": {
+            "description": "Must be `EVENT`."
+          }
         },
         "name": {
           "type": "string",
@@ -2241,7 +2244,7 @@
         "eventData": {
           "ref": "AppEmbedData_EventData",
           "metadata": {
-            "description": "Embedded Wix Events app content."
+            "description": "Embedded event content."
           }
         },
         "image": {
@@ -2268,7 +2271,7 @@
     "AppEmbedDataBooking": {
       "metadata": {
         "section": "App Embed",
-        "description": "Wix Bookings app. Embeds a particular booking."
+        "description": "Embeds a booking from Wix Bookings."
       },
       "properties": {
         "type": {
@@ -2305,7 +2308,7 @@
         "bookingData": {
           "ref": "AppEmbedData_BookingData",
           "metadata": {
-            "description": "Embedded Wix Bookings app content."
+            "description": "Embedded booking content."
           }
         },
         "imageSrc": {
@@ -2358,7 +2361,7 @@
         "features": [
           "AUDIO"
         ],
-        "description": "A multimedia node used to embed and play audio content directly in a webpage. When rendered, it is displayed as the audio player with the specified audio file (can be a platform such as Spotify or Soundloud, and Wix Media). Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio."
+        "description": "Embeds and plays audio content directly in a webpage. Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio."
       },
       "properties": {
         "type": {
@@ -2366,7 +2369,7 @@
             "AUDIO"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `AUDIO`"
+            "description": "Node type. \n Must be `AUDIO`."
           }
         }
       },
@@ -2410,7 +2413,7 @@
         },
         "disableDownload": {
           "metadata": {
-            "description": "Sets whether the audio download button is disabled. \n Default: `false`"
+            "description": "Whether the audio download button is disabled. \n Default: `false`"
           },
           "type": "boolean"
         },
@@ -2434,7 +2437,7 @@
         },
         "html": {
           "metadata": {
-            "description": "An HTML version of the audio node."
+            "description": "HTML version of the audio node."
           },
           "type": "string"
         }
@@ -2454,7 +2457,7 @@
         "features": [
           "BUTTON"
         ],
-        "description": "A node that is used to trigger an action when clicked or activated."
+        "description": "Button to trigger an action."
       },
       "properties": {
         "type": {
@@ -2462,7 +2465,7 @@
             "BUTTON"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `BUTTON`"
+            "description": "Node type. \n Must be `BUTTON`"
           }
         },
         "buttonData": {
@@ -2499,7 +2502,7 @@
           ],
           "metadata": {
             "emitEnum": "ButtonData_Type",
-            "description": "Button type. Possible values: <br> - `LINK`: When clicked, a user is redirected. <br> - `ACTION`: When clicked, performs an action."
+            "description": "Button type. Supported values: <br> - `LINK`: Redirects to a webpage. <br> - `ACTION`: Performs an action."
           }
         },
         "text": {
@@ -2513,7 +2516,7 @@
         "containerData": {
           "ref": "PluginContainerData",
           "metadata": {
-            "description": " Button container styling."
+            "description": "Button container styling."
           }
         },
         "styles": {
@@ -2557,19 +2560,19 @@
         "text": {
           "type": "string",
           "metadata": {
-            "description": "The text color in a hexadecimal value."
+            "description": "Text color as a hexadecimal value."
           }
         },
         "border": {
           "type": "string",
           "metadata": {
-            "description": "The border color in a hexadecimal value."
+            "description": "Border color as a hexadecimal value."
           }
         },
         "background": {
           "type": "string",
           "metadata": {
-            "description": "The background color in a hexadecimal value."
+            "description": "Background color as a hexadecimal value."
           }
         }
       },
@@ -2605,7 +2608,7 @@
         "features": [
           "COLLAPSIBLE_LIST"
         ],
-        "description": "A list of items where each item can be expanded or collapsed to reveal or hide additional content associated with it."
+        "description": "List of items where each item can be expanded or collapsed."
       },
       "properties": {
         "type": {
@@ -2613,7 +2616,7 @@
             "COLLAPSIBLE_LIST"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `COLLAPSIBLE_LIST`"
+            "description": "Node type. \n Must be `COLLAPSIBLE_LIST`"
           }
         },
         "nodes": {
@@ -2655,7 +2658,7 @@
         "expandOnlyOne": {
           "type": "boolean",
           "metadata": {
-            "description": "Whether only one item can be expanded at a time. \n Default: `false` "
+            "description": "Whether only one item can be expanded at a time. \n Default: `false`."
           }
         },
         "initialExpandedItems": {
@@ -2668,7 +2671,7 @@
             "metadata": {
               "emitEnum": "CollapsibleListData_InitialExpandedItems"
             },
-            "description": "Sets which items are automatically expanded after the page loads. Possible values: \n - `FIRST` \n - `ALL` \n - `NONE`"
+            "description": "Sets which items are automatically expanded after the page loads."
           }
         },
         "direction": {
@@ -2678,13 +2681,13 @@
           ],
           "metadata": {
             "emitEnum": "CollapsibleListData_Direction",
-            "description": "Direction of the text in the list. Possible values: \n - `LTR`: Left to right. \n - `RTL`: Right to left."
+            "description": "Direction of the text in the list. Supported values: \n - `LTR`: Left to right. \n - `RTL`: Right to left."
           }
         },
         "isQapageData": {
           "type": "boolean",
           "metadata": {
-            "description": "Whether the collapsible item will appear in search results as a FAQ."
+            "description": "Whether the collapsible item will appear in search results as an FAQ."
           }
         }
       },
@@ -2699,7 +2702,7 @@
             "COLLAPSIBLE_ITEM"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `COLLAPSIBLE_ITEM`"
+            "description": "Node type. \n Must be `COLLAPSIBLE_ITEM`"
           }
         },
         "nodes": {
@@ -2741,7 +2744,7 @@
         "COLLAPSIBLE_ITEM_TITLE": {
           "metadata": {
             "section": "Collapsible List",
-            "description": "Collapsible list item title node."
+            "description": "Collapsible list item title."
           },
           "properties": {
             "nodes": {
@@ -2770,7 +2773,7 @@
         "COLLAPSIBLE_ITEM_BODY": {
           "metadata": {
             "section": "Collapsible List",
-            "description": "Collapsible list item body node."
+            "description": "Collapsible list item body."
           },
           "properties": {
             "nodes": {
@@ -2800,7 +2803,7 @@
     "CollapsibleItemTitleNode": {
       "metadata": {
         "section": "Collapsible List",
-        "description": "Collapsible list item title node."
+        "description": "Collapsible list item title."
       },
       "properties": {
         "type": {
@@ -2808,7 +2811,7 @@
             "COLLAPSIBLE_ITEM_TITLE"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `COLLAPSIBLE_ITEM_TITLE`"
+            "description": "Node type. \n Must be `COLLAPSIBLE_ITEM_TITLE`."
           }
         },
         "nodes": {
@@ -2851,7 +2854,7 @@
         "PARAGRAPH": {
           "metadata": {
             "section": "Paragraph",
-            "description": "Used to structure text content, providing a clear separation between different ideas or sections of text. They are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
+            "description": "Structures text content, providing a clear separation between different ideas or sections of text. Paragraphs are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
             "examples": [
               "paragraph"
             ]
@@ -2876,7 +2879,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Paragraphs vertical padding. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Vertical padding. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "paragraphData": {
@@ -2893,7 +2896,7 @@
             "examples": [
               "headings-all-sizes"
             ],
-            "description": "Used to denote the heading or title of a section. Headings are hierarchical, with different levels indicating the relative importance of the heading in the content's structure. There are 6 levels of headings, where `1` is the highest level and `6` is the lowest."
+            "description": "Indicates a heading or title of a section. There are 6 levels of headings, with `1` being the most prominent and `6` being the least."
           },
           "properties": {},
           "optionalProperties": {
@@ -2915,7 +2918,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the heading style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Heading styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "headingData": {
@@ -2932,7 +2935,7 @@
             "examples": [
               "bulletedList"
             ],
-            "description": "Presents a group of items in a visually organized manner, where each item is preceded by a bullet point. Bulleted lists are commonly used to present unordered information."
+            "description": "Bulleted list."
           },
           "properties": {
             "nodes": {
@@ -2974,7 +2977,7 @@
             "examples": [
               "orderedList"
             ],
-            "description": "Presents a group of items in a sequentially numbered or lettered manner. Ordered lists are used to represent information that has a specific order or sequence."
+            "description": "Numbered list."
           },
           "properties": {
             "nodes": {
@@ -3016,7 +3019,7 @@
             "examples": [
               "blockquote"
             ],
-            "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it is displayed as the quoted text with indentation or other styling to visually separate it from the surrounding content."
+            "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it displays as the quoted text with indentation or other styling to visually separate it from the surrounding content."
           },
           "properties": {
             "nodes": {
@@ -3049,7 +3052,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             }
           }
@@ -3064,7 +3067,7 @@
               "code-block-multi-line",
               "code-block-syntax-highlighting"
             ],
-            "description": "Used to present programming code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
+            "description": "Presents code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
           },
           "properties": {},
           "optionalProperties": {
@@ -3092,7 +3095,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Code block styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             }
           }
@@ -3102,7 +3105,7 @@
     "CollapsibleItemBodyNode": {
       "metadata": {
         "section": "Collapsible List",
-        "description": "Collapsible list item body node."
+        "description": "Collapsible list item body."
       },
       "properties": {
         "type": {
@@ -3110,7 +3113,7 @@
             "COLLAPSIBLE_ITEM_BODY"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `COLLAPSIBLE_ITEM_BODY`"
+            "description": "Node type. \n Must be `COLLAPSIBLE_ITEM_BODY`."
           }
         },
         "nodes": {
@@ -3162,13 +3165,13 @@
           "POLL": "PollNode",
           "HTML": "HtmlNode"
         },
-        "description": "Collapsible list item body node."
+        "description": "Collapsible list item body."
       },
       "mapping": {
         "PARAGRAPH": {
           "metadata": {
             "section": "Paragraph",
-            "description": "Used to structure text content, providing a clear separation between different ideas or sections of text. They are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
+            "description": "Structures text content, providing a clear separation between different ideas or sections of text. Paragraphs are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
             "examples": [
               "paragraph"
             ]
@@ -3193,7 +3196,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Paragraphs vertical padding. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Vertical padding. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "paragraphData": {
@@ -3210,7 +3213,7 @@
             "examples": [
               "headings-all-sizes"
             ],
-            "description": "Used to denote the heading or title of a section. Headings are hierarchical, with different levels indicating the relative importance of the heading in the content's structure. There are 6 levels of headings, where `1` is the highest level and `6` is the lowest."
+            "description": "Indicates a heading or title of a section. There are 6 levels of headings, with `1` being the most prominent and `6` being the least."
           },
           "properties": {},
           "optionalProperties": {
@@ -3232,7 +3235,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the heading style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Heading styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "headingData": {
@@ -3249,7 +3252,7 @@
             "examples": [
               "bulletedList"
             ],
-            "description": "Presents a group of items in a visually organized manner, where each item is preceded by a bullet point. Bulleted lists are commonly used to present unordered information."
+            "description": "Bulleted list."
           },
           "properties": {
             "nodes": {
@@ -3291,7 +3294,7 @@
             "examples": [
               "orderedList"
             ],
-            "description": "Presents a group of items in a sequentially numbered or lettered manner. Ordered lists are used to represent information that has a specific order or sequence."
+            "description": "Numbered list."
           },
           "properties": {
             "nodes": {
@@ -3333,7 +3336,7 @@
             "examples": [
               "blockquote"
             ],
-            "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it is displayed as the quoted text with indentation or other styling to visually separate it from the surrounding content."
+            "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it displays as the quoted text with indentation or other styling to visually separate it from the surrounding content."
           },
           "properties": {
             "nodes": {
@@ -3366,7 +3369,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             }
           }
@@ -3380,7 +3383,7 @@
             "features": [
               "AUDIO"
             ],
-            "description": "A multimedia node used to embed and play audio content directly in a webpage. When rendered, it is displayed as the audio player with the specified audio file (can be a platform such as Spotify or Soundloud, and Wix Media). Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio."
+            "description": "Embeds and plays audio content directly in a webpage. Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio."
           },
           "properties": {},
           "optionalProperties": {
@@ -3416,7 +3419,7 @@
             "features": [
               "FILE"
             ],
-            "description": "A digital file stored on a computer that is uploaded and accessed in a page. Files can include various types of content, such as text documents, images, videos, and so on."
+            "description": "File that is uploaded and accessed in a page. Files can be different types of content, such as text documents, images, and videos."
           },
           "properties": {
             "fileData": {
@@ -3454,7 +3457,7 @@
             "features": [
               "IMAGE"
             ],
-            "description": "Displays standalone pictures in a page."
+            "description": "Standalone images in a page."
           },
           "properties": {
             "imageData": {
@@ -3492,7 +3495,7 @@
             "features": [
               "VIDEO"
             ],
-            "description": "A multimedia node that is used to embed and play video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
+            "description": "Embeds and plays video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
           },
           "properties": {
             "videoData": {
@@ -3529,7 +3532,7 @@
             "features": [
               "GIF"
             ],
-            "description": "GIF images are made up of a series of frames, allowing them to display animations or short video clips without the need for additional plugins or technologies."
+            "description": "GIF images."
           },
           "properties": {
             "gifData": {
@@ -3566,7 +3569,7 @@
             "features": [
               "DIVIDER"
             ],
-            "description": "A visual node that is used to separate content sections in a page. When rendered, it is displayed as a horizontal line between the paragraphs, acting as a divider between them."
+            "description": "Horizontal line between different content."
           },
           "properties": {},
           "optionalProperties": {
@@ -3603,7 +3606,7 @@
               "code-block-multi-line",
               "code-block-syntax-highlighting"
             ],
-            "description": "Used to present programming code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
+            "description": "Presents code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
           },
           "properties": {},
           "optionalProperties": {
@@ -3631,7 +3634,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Code block styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             }
           }
@@ -3646,13 +3649,13 @@
             "features": [
               "APP_EMBED"
             ],
-            "description": "Similar to `LinkPreviewNode`, this node is used to embed external content preview, but from Wix business solutions. You can embed previews from the Wix Bookings, Wix Stores and Wix Events apps."
+            "description": "Embeds an external content preview from Wix business solutions. For example, you can embed previews from the Wix Bookings, Wix Stores and Wix Events apps."
           },
           "properties": {
             "appEmbedData": {
               "ref": "AppEmbedData",
               "metadata": {
-                "description": "Embedded Wix app details."
+                "description": "Embedded Wix app."
               }
             }
           },
@@ -3683,7 +3686,7 @@
             "features": [
               "LINK_PREVIEW"
             ],
-            "description": "A preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and possibly a thumbnail image or other relevant information."
+            "description": "Preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and sometimes a thumbnail image or other relevant information."
           },
           "properties": {
             "linkPreviewData": {
@@ -3720,7 +3723,7 @@
             "features": [
               "GALLERY"
             ],
-            "description": "A collection of images displayed together in a visually appealing and organized manner."
+            "description": "Collection of images displayed together."
           },
           "properties": {
             "galleryData": {
@@ -3759,7 +3762,7 @@
             "features": [
               "BUTTON"
             ],
-            "description": "A node that is used to trigger an action when clicked or activated."
+            "description": "Button to trigger an action."
           },
           "properties": {
             "buttonData": {
@@ -3796,7 +3799,7 @@
             "features": [
               "COLLAPSIBLE_LIST"
             ],
-            "description": "A list of items where each item can be expanded or collapsed to reveal or hide additional content associated with it."
+            "description": "List of items where each item can be expanded or collapsed."
           },
           "properties": {
             "nodes": {
@@ -3836,7 +3839,7 @@
             "features": [
               "TABLE"
             ],
-            "description": "A structural node used to display data in rows and columns."
+            "description": "Data in rows and columns."
           },
           "properties": {
             "nodes": {
@@ -3876,7 +3879,7 @@
             "features": [
               "EMBED"
             ],
-            "description": "Similar to `HtmlNode`, this node is used to display embedded content when you post a link to that resource, without having to parse the resource directly. It provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers without needing to handle the complex embedding code themselves. For more information, read [oembed](https://oembed.com/)."
+            "description": "Embedded content when you include a link to a resource, without having to parse the resource directly. This provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers. To learn more, see [oembed](https://oembed.com/)."
           },
           "properties": {
             "embedData": {
@@ -3913,7 +3916,7 @@
             "features": [
               "POLL"
             ],
-            "description": "A node that allows users to vote or express their opinions on a particular question, topic, or issue."
+            "description": "Provides a question with several options, where the options' cumulative total may be shown."
           },
           "properties": {
             "pollData": {
@@ -3951,7 +3954,7 @@
             "features": [
               "HTML"
             ],
-            "description": "Incorporates external content, such as interactive maps, or entire web pages."
+            "description": "HTML block that incorporates external content, such as interactive maps or entire web pages."
           },
           "properties": {
             "htmlData": {
@@ -3990,7 +3993,7 @@
         "features": [
           "DIVIDER"
         ],
-        "description": "A visual node that is used to separate content sections in a page. When rendered, it is displayed as a horizontal line between the paragraphs, acting as a divider between them."
+        "description": "Horizontal line between different content."
       },
       "properties": {
         "type": {
@@ -3998,7 +4001,7 @@
             "DIVIDER"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `DIVIDER`"
+            "description": "Node type. \n Must be `DIVIDER`."
           }
         }
       },
@@ -4043,7 +4046,7 @@
           ],
           "metadata": {
             "emitEnum": "DividerData_LineStyle",
-            "description": "Divider line style. Possible values: <br> - `SINGLE` <br> - `DOUBLE` <br> - `DASHED` <br> - `DOTTED`"
+            "description": "Divider line style."
           }
         },
         "width": {
@@ -4054,7 +4057,7 @@
           ],
           "metadata": {
             "emitEnum": "DividerData_Width",
-            "description": "Divider width. Possible values: <br> - `LARGE` <br> - `MEDIUM` <br> - `SMALL`"
+            "description": "Divider width."
           }
         },
         "alignment": {
@@ -4065,7 +4068,7 @@
           ],
           "metadata": {
             "emitEnum": "DividerData_Alignment",
-            "description": "Divider alignment. Possible values: <br> - `CENTER` <br> - `LEFT` <br> - `RIGHT`"
+            "description": "Divider alignment."
           }
         }
       },
@@ -4082,7 +4085,7 @@
         "features": [
           "EMBED"
         ],
-        "description": "Similar to `HtmlNode`, this node is used to display embedded content when you post a link to that resource, without having to parse the resource directly. It provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers without needing to handle the complex embedding code themselves. For more information, read [oembed](https://oembed.com/)."
+        "description": "Embedded content when you include a link to a resource, without having to parse the resource directly. This provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers. To learn more, see [oembed](https://oembed.com/)."
       },
       "properties": {
         "type": {
@@ -4090,7 +4093,7 @@
             "EMBED"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `EMBED`"
+            "description": "Node type. \n Must be `EMBED`."
           }
         },
         "embedData": {
@@ -4147,7 +4150,7 @@
       "optionalProperties": {
         "type": {
           "metadata": {
-            "description": "Resource type. For more information read the [oEmbed](https://www.oembed.com) official website."
+            "description": "Resource type."
           },
           "type": "string"
         },
@@ -4165,19 +4168,19 @@
         },
         "title": {
           "metadata": {
-            "description": "A text title, describing the resource."
+            "description": "Resource title."
           },
           "type": "string"
         },
         "url": {
           "metadata": {
-            "description": "The source URL for the resource."
+            "description": "Resource source URL."
           },
           "type": "string"
         },
         "html": {
           "metadata": {
-            "description": "HTML required to embed a video player. The HTML should have no padding or margins."
+            "description": "HTML to embed a video player. The HTML should have no padding or margins."
           },
           "type": "string"
         },
@@ -4207,31 +4210,31 @@
         },
         "thumbnailUrl": {
           "metadata": {
-            "description": "URL for a thumbnail image for the resource. If this property is defined, `thumbnailWidth` and `thumbnailHeight` must also be defined."
+            "description": "Thumbnail image URL for the resource. If defined, `thumbnailWidth` and `thumbnailHeight` must also be defined."
           },
           "type": "string"
         },
         "thumbnailWidth": {
           "metadata": {
-            "description": "Width of the resource's thumbnail image. If this property is defined, `thumbnailUrl` and `thumbnailHeight` must also be defined."
+            "description": "Resource's thumbnail image width. If defined, `thumbnailUrl` and `thumbnailHeight` must also be defined."
           },
           "type": "string"
         },
         "thumbnailHeight": {
           "metadata": {
-            "description": "Height of the resource's thumbnail image. If this property is defined, `thumbnailUrl` and `thumbnailWidth`must also be defined."
+            "description": "Resource's thumbnail image height. If defined, `thumbnailUrl` and `thumbnailWidth`must also be defined."
           },
           "type": "string"
         },
         "videoUrl": {
           "metadata": {
-            "description": "URL for an embedded video."
+            "description": "Embedded video URL."
           },
           "type": "string"
         },
         "version": {
           "metadata": {
-            "description": "The oEmbed version number.  This value must be `1.0`."
+            "description": "The oEmbed version number. Must be `1.0`."
           },
           "type": "string"
         }
@@ -4249,7 +4252,7 @@
         "features": [
           "FILE"
         ],
-        "description": "A digital file stored on a computer that is uploaded and accessed in a page. Files can include various types of content, such as text documents, images, videos, and so on."
+        "description": "File that is uploaded and accessed in a page. Files can be different types of content, such as text documents, images, and videos."
       },
       "properties": {
         "type": {
@@ -4257,7 +4260,7 @@
             "FILE"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `FILE`"
+            "description": "Node type. \n Must be `FILE`."
           }
         },
         "fileData": {
@@ -4313,7 +4316,7 @@
         },
         "size": {
           "metadata": {
-            "description": "Deprecated. Replaced by sizeInKb",
+            "description": "Deprecated. Replaced by `sizeInKb`",
             "deprecated": true
           },
           "type": "uint32"
@@ -4352,7 +4355,7 @@
         "viewMode": {
           "metadata": {
             "emitEnum": "FileData_PDFSettings_ViewMode",
-            "description": "PDF view mode. Possible values: \n - `NONE`: The PDF isn't displayed. \n - `FULL`: A full PDF page view is displayed. \n - `MINI`: A mini view of the PDF is displayed."
+            "description": "PDF view mode. Supported values: \n - `NONE`: PDF isn't displayed. \n - `FULL`: Full PDF page view is displayed. \n - `MINI`: Mini view of the PDF is displayed."
           },
           "enum": [
             "NONE",
@@ -4386,7 +4389,7 @@
         "features": [
           "GALLERY"
         ],
-        "description": "A collection of images displayed together in a visually appealing and organized manner."
+        "description": "Collection of images displayed together."
       },
       "properties": {
         "type": {
@@ -4394,7 +4397,7 @@
             "GALLERY"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `GALLERY`"
+            "description": "Node type. \n Must be `GALLERY`."
           }
         },
         "galleryData": {
@@ -4452,13 +4455,13 @@
         "disableExpand": {
           "type": "boolean",
           "metadata": {
-            "description": "Whether the expand button is disabled. Default: `false`"
+            "description": "Whether the expand button is disabled. \nDefault: `false`"
           }
         },
         "disableDownload": {
           "type": "boolean",
           "metadata": {
-            "description": "Whether the download button is disabled. Default: `false`"
+            "description": "Whether the download button is disabled. \nDefault: `false`"
           }
         }
       },
@@ -4496,7 +4499,7 @@
         "type": {
           "metadata": {
             "emitEnum": "GalleryOptions_Layout_Type",
-            "description": "Gallery layout type. Possible values: <br> - `COLLAGE`: Presents images in various sizes and positions, creating an artistic or dynamic layout. <br> - `MASONRY`: A grid-based design that places items in optimal positions based on available vertical space, creating an arrangement where items of varying heights fit together like bricks in a wall. <br> - `GRID`: A layout structure that organizes items into rows and columns, creating a clean, uniform, and visually appealing arrangement of images. <br> - `THUMBNAIL`: A smaller, scaled-down version of an image that serves as a preview. <br> - `SLIDER`: A component that allows users to browse through a set of images by sliding or swiping through them, typically in a confined viewing area. <br> - `SLIDESHOW`: A component that automatically or manually transitions through a set of images in a designated area. <br> - `PANORAMA`: Wide-angle or 360-degree image that allows users to view an extended horizontal view of a scene. <br> - `COLUMN`: Arrangement of the gallery items in vertical sections. <br> - `MAGIC`: Visually stunning, dynamic effects that enhance the user experience. <br> - `FULLSIZE`: A layout where each image or item is displayed at its full size, taking up the entire viewport or a significant portion of the screen.."
+            "description": "Gallery layout. Supported values: <br> - `COLLAGE`: Presents images in various sizes and positions, creating an artistic or dynamic layout. <br> - `MASONRY`: Grid-based design that places items in optimal positions based on available vertical space, creating an arrangement where items of varying heights fit together like bricks in a wall. <br> - `GRID`: A layout structure that organizes items into rows and columns, creating a uniform arrangement of images. <br> - `THUMBNAIL`: Smaller, scaled-down version of an image that serves as a preview. <br> - `SLIDER`: Component that allows users to browse through a set of images by sliding or swiping through them, typically in a confined viewing area. <br> - `SLIDESHOW`: A component that automatically or manually transitions through a set of images in a designated area. <br> - `PANORAMA`: Wide-angle or 360-degree image that allows users to view an extended horizontal view of a scene. <br> - `COLUMN`: Arrangement of the gallery items in vertical sections. <br> - `MAGIC`: Visually stunning, dynamic effects that enhance the user experience. <br> - `FULLSIZE`: A layout where each image or item is displayed at its full size, sometimes  taking up the entire viewport or a significant portion of the screen."
           },
           "enum": [
             "COLLAGE",
@@ -4514,12 +4517,12 @@
         "horizontalScroll": {
           "type": "boolean",
           "metadata": {
-            "description": "Whether the horizontal scroll is enabled. Default: `true`, unless the `type` field is set to `GRID` or `COLLAGE`."
+            "description": "Whether the horizontal scroll is enabled. \nDefault: `true`, unless the `type` field is set to `GRID` or `COLLAGE`."
           }
         },
         "orientation": {
           "metadata": {
-            "description": "Gallery orientation. Possible values: <br> - `ROWS`: Gallery items are arranged horizontally in rows. <br> - `COLUMNS`: Gallery items are arranged vertically in columns.",
+            "description": "Gallery orientation.",
             "emitEnum": "GalleryOptions_Layout_Orientation"
           },
           "enum": [
@@ -4530,13 +4533,13 @@
         "numberOfColumns": {
           "type": "int32",
           "metadata": {
-            "description": "The number of columns to display on computer screens."
+            "description": "Number of columns to display on computer screens."
           }
         },
         "mobileNumberOfColumns": {
           "type": "int32",
           "metadata": {
-            "description": "The number of columns to display on mobile phone screens."
+            "description": "Number of columns to display on mobile phone screens."
           }
         }
       },
@@ -4549,18 +4552,18 @@
         "targetSize": {
           "type": "int32",
           "metadata": {
-            "description": "Dimension for each gallery item in pixels (behavaior changes according to a gallery type)."
+            "description": "Dimensions for each gallery item in pixels. Behavior may change with gallery type."
           }
         },
         "ratio": {
           "type": "float64",
           "metadata": {
-            "description": "Item ratio"
+            "description": "Height to width ratio."
           }
         },
         "crop": {
           "metadata": {
-            "description": "Sets how gallery item images are cropped. Possible values: <br> - `FILL`: Each item in the gallery is cropped and resized to completely fill its container, ensuring that no empty space is left while maintaining the aspect ratio of the original image. <br> - `FIT`: Each item in the gallery is resized to fit entirely in its container without any cropping.",
+            "description": "Cropping strategy. Supported values: <br> - `FILL`: Each item in the gallery is cropped and resized to completely fill its container. <br> - `FIT`: Each item in the gallery is resized to fit exactly in its container without cropping.",
             "emitEnum": "GalleryOptions_ItemStyle_Crop"
           },
           "enum": [
@@ -4571,7 +4574,7 @@
         "spacing": {
           "type": "int32",
           "metadata": {
-            "description": "The spacing between gallery items in pixels."
+            "description": "Spacing between gallery items in pixels."
           }
         }
       },
@@ -4584,7 +4587,7 @@
         "placement": {
           "metadata": {
             "emitEnum": "GalleryOptions_Thumbnails_Alignment",
-            "description": "Thumbnail alignment. Possible values: <br> - `TOP` <br> - `RIGHT` <br> - `BOTTOM` <br> - `LEFT` <br> - `NONE`"
+            "description": "Thumbnail alignment."
           },
           "enum": [
             "TOP",
@@ -4677,7 +4680,7 @@
         "link": {
           "ref": "Link",
           "metadata": {
-            "description": "Link details for images that are links."
+            "description": "Link details for images, if relevant."
           }
         }
       },
@@ -4694,7 +4697,7 @@
         "features": [
           "GIF"
         ],
-        "description": "GIF images are made up of a series of frames, allowing them to display animations or short video clips without the need for additional plugins or technologies."
+        "description": "GIF images."
       },
       "properties": {
         "type": {
@@ -4702,7 +4705,7 @@
             "GIF"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `GIF`"
+            "description": "Node type. \n Must be `GIF`."
           }
         },
         "gifData": {
@@ -4735,7 +4738,7 @@
         "containerData": {
           "ref": "PluginContainerData",
           "metadata": {
-            "description": "Styling for the GIF container, such as dimensions and alignment."
+            "description": "GIF container styling."
           }
         },
         "original": {
@@ -4773,14 +4776,14 @@
           "type": "string",
           "metadata": {
             "format": "WEB_URL",
-            "description": "URL for a file in GIF format."
+            "description": "GIF source URL."
           }
         },
         "mp4": {
           "type": "string",
           "metadata": {
             "format": "WEB_URL",
-            "description": "URL for a file in MP4 format."
+            "description": "MP4 source URL."
           }
         },
         "still": {
@@ -4805,7 +4808,7 @@
         "features": [
           "HTML"
         ],
-        "description": "Incorporates external content, such as interactive maps, or entire web pages."
+        "description": "HTML block that incorporates external content, such as interactive maps or entire web pages."
       },
       "properties": {
         "type": {
@@ -4813,7 +4816,7 @@
             "HTML"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `HTML`"
+            "description": "Node type. \n Mst be `HTML`."
           }
         },
         "htmlData": {
@@ -4860,7 +4863,7 @@
         },
         "source": {
           "metadata": {
-            "description": "HTML code type. Possible values: \n - `HTML`: HTML code. \n - [`ADSENSE`](https://adsense.google.com/start/): A service provided by Google for serving advertisements on web pages.",
+            "description": "HTML code type. Possible values: \n - `HTML`: HTML code. \n - [`ADSENSE`](https://adsense.google.com/start/): Service provided by Google for rendering advertisements on web pages.",
             "emitEnum": "HTMLData_Source"
           },
           "enum": [
@@ -4892,7 +4895,7 @@
         "features": [
           "IMAGE"
         ],
-        "description": "Displays standalone pictures in a page."
+        "description": "Standalone images in a page."
       },
       "properties": {
         "type": {
@@ -4900,7 +4903,7 @@
             "IMAGE"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `IMAGE`"
+            "description": "Node type. \n Must be `IMAGE`."
           }
         },
         "imageData": {
@@ -4933,7 +4936,7 @@
         "image": {
           "ref": "Media",
           "metadata": {
-            "description": "Image file details, such as source and dimensions."
+            "description": "Image file details."
           }
         }
       },
@@ -4941,13 +4944,13 @@
         "containerData": {
           "ref": "PluginContainerData",
           "metadata": {
-            "description": "Styling for the image container, such as dimensions and alignment."
+            "description": "Image container styling."
           }
         },
         "link": {
           "ref": "Link",
           "metadata": {
-            "description": "Link details, such as URL, or anchor, if image is also used as a link."
+            "description": "Image link details."
           }
         },
         "disableExpand": {
@@ -4959,7 +4962,7 @@
         "altText": {
           "type": "string",
           "metadata": {
-            "description": "An alternate text for an image. Used for improved accessibility and shown when the image can't be displayed."
+            "description": "Alternate text to display when the image doesn't load."
           }
         },
         "caption": {
@@ -4989,7 +4992,7 @@
         "features": [
           "LINK_PREVIEW"
         ],
-        "description": "A preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and possibly a thumbnail image or other relevant information."
+        "description": "Preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and sometimes a thumbnail image or other relevant information."
       },
       "properties": {
         "type": {
@@ -4997,7 +5000,7 @@
             "LINK_PREVIEW"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `LINK_PREVIEW`"
+            "description": "Node type. \n Must be `LINK_PREVIEW`."
           }
         },
         "linkPreviewData": {
@@ -5077,7 +5080,7 @@
         "features": [
           "POLL"
         ],
-        "description": "A node that allows users to vote or express their opinions on a particular question, topic, or issue."
+        "description": "Provides a question with several options, where the options' cumulative total may be shown."
       },
       "properties": {
         "type": {
@@ -5085,7 +5088,7 @@
             "POLL"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `POLL`"
+            "description": "Node type. \n Must be `POLL`."
           }
         },
         "pollData": {
@@ -5176,7 +5179,7 @@
             "ref": "PollData_Poll_Option"
           },
           "metadata": {
-            "description": " Poll details."
+            "description": "Poll details."
           }
         },
         "settings": {
@@ -5220,7 +5223,7 @@
         "permissions": {
           "ref": "PollData_Poll_Settings_Permissions",
           "metadata": {
-            "description": "Permission settings for voting."
+            "description": "Voting permission settings."
           }
         },
         "showVoters": {
@@ -5245,7 +5248,7 @@
         "view": {
           "metadata": {
             "emitEnum": "PollData_Poll_Settings_Permissions_ViewRole",
-            "description": "Who can view the poll results. Possible values: \n - `CREATOR`: Only poll creator can see the results. \n - `VOTERS`: Only voters can see the results. \n - `EVERYONE`: Anyone who visits the site can see the results."
+            "description": "Who can view the poll results."
           },
           "enum": [
             "CREATOR",
@@ -5255,7 +5258,7 @@
         },
         "vote": {
           "metadata": {
-            "description": "Who can vote. Possble values: \n - `SITE_MEMBERS`: Only site members can vote. \n - `ALL`: All site visitors can vote.",
+            "description": "Who can vote.",
             "emitEnum": "PollData_Poll_Settings_Permissions_VoteRole"
           },
           "enum": [
@@ -5266,7 +5269,7 @@
         "allowMultipleVotes": {
           "type": "boolean",
           "metadata": {
-            "description": "Whether one site visitor can vote multiple times. \n Default: `false`"
+            "description": "Whether a user can vote multiple times. \n Default: `false`"
           }
         }
       },
@@ -5302,7 +5305,7 @@
           ],
           "metadata": {
             "emitEnum": "PollData_Layout_PollLayout_Type",
-            "description": "Voting options layout. Possible values: <br> - `LIST`: Options are displayed as a list. <br> - `GRID`: Options are displayed in a grid.."
+            "description": "Voting options layout."
           }
         },
         "direction": {
@@ -5312,7 +5315,7 @@
           ],
           "metadata": {
             "emitEnum": "PollData_Layout_PollLayout_Direction",
-            "description": "Direction of the text in the poll. Possible values: <br> - `LTR`: Left to right. <br> - `RTL`: Right to left."
+            "description": "Direction of the text in the poll. Supported values: <br> - `LTR`: Left to right. <br> - `RTL`: Right to left."
           }
         },
         "enableImage": {
@@ -5396,7 +5399,7 @@
               "type": "string",
               "metadata": {
                 "format": "COLOR_HEX",
-                "description": "The background color in a hexademical value."
+                "description": "Background color as a hexademical value."
               }
             }
           },
@@ -5447,7 +5450,7 @@
           "type": "string",
           "metadata": {
             "format": "COLOR_HEX",
-            "description": "The background color in a hexademical value."
+            "description": "Background color as a hexademical value."
           }
         }
       },
@@ -5514,7 +5517,7 @@
           "type": "string",
           "metadata": {
             "format": "COLOR_HEX",
-            "description": "end color as a hexadecimal value."
+            "description": "End color as a hexadecimal value."
           }
         }
       },
@@ -5544,7 +5547,7 @@
         "features": [
           "TABLE"
         ],
-        "description": "A structural node used to display data in rows and columns."
+        "description": "Data in rows and columns."
       },
       "properties": {
         "type": {
@@ -5552,7 +5555,7 @@
             "TABLE"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `TABLE`"
+            "description": "Node type. \n Must be `TABLE`."
           }
         },
         "nodes": {
@@ -5590,7 +5593,7 @@
             "TABLE_ROW"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `TABLE_ROW`"
+            "description": "Node type. \n Must be `TABLE_ROW`."
           }
         },
         "nodes": {
@@ -5622,7 +5625,7 @@
       "optionalProperties": {
         "containerData": {
           "metadata": {
-            "description": "Styling for the table container, such as dimensions and alignment."
+            "description": "Table container styling."
           },
           "ref": "PluginContainerData"
         },
@@ -5656,7 +5659,7 @@
             "type": "float64"
           },
           "metadata": {
-            "description": "Each column width as related to the width of table."
+            "description": "Each column width as a fraction to the width of table."
           }
         },
         "rowsHeight": {
@@ -5687,7 +5690,7 @@
             "TABLE_CELL"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `TABLE_CELL`"
+            "description": "Node type. \n Must be `TABLE_CELL`."
           }
         },
         "nodes": {
@@ -5750,7 +5753,7 @@
         "PARAGRAPH": {
           "metadata": {
             "section": "Paragraph",
-            "description": "Used to structure text content, providing a clear separation between different ideas or sections of text. They are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
+            "description": "Structures text content, providing a clear separation between different ideas or sections of text. Paragraphs are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
             "examples": [
               "paragraph"
             ]
@@ -5775,7 +5778,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Paragraphs vertical padding. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Vertical padding. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "paragraphData": {
@@ -5792,7 +5795,7 @@
             "examples": [
               "headings-all-sizes"
             ],
-            "description": "Used to denote the heading or title of a section. Headings are hierarchical, with different levels indicating the relative importance of the heading in the content's structure. There are 6 levels of headings, where `1` is the highest level and `6` is the lowest."
+            "description": "Indicates a heading or title of a section. There are 6 levels of headings, with `1` being the most prominent and `6` being the least."
           },
           "properties": {},
           "optionalProperties": {
@@ -5814,7 +5817,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the heading style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Heading styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "headingData": {
@@ -5831,7 +5834,7 @@
             "examples": [
               "bulletedList"
             ],
-            "description": "Presents a group of items in a visually organized manner, where each item is preceded by a bullet point. Bulleted lists are commonly used to present unordered information."
+            "description": "Bulleted list."
           },
           "properties": {
             "nodes": {
@@ -5873,7 +5876,7 @@
             "examples": [
               "orderedList"
             ],
-            "description": "Presents a group of items in a sequentially numbered or lettered manner. Ordered lists are used to represent information that has a specific order or sequence."
+            "description": "Numbered list."
           },
           "properties": {
             "nodes": {
@@ -5915,7 +5918,7 @@
             "examples": [
               "blockquote"
             ],
-            "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it is displayed as the quoted text with indentation or other styling to visually separate it from the surrounding content."
+            "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it displays as the quoted text with indentation or other styling to visually separate it from the surrounding content."
           },
           "properties": {
             "nodes": {
@@ -5948,7 +5951,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             }
           }
@@ -5962,7 +5965,7 @@
             "features": [
               "AUDIO"
             ],
-            "description": "A multimedia node used to embed and play audio content directly in a webpage. When rendered, it is displayed as the audio player with the specified audio file (can be a platform such as Spotify or Soundloud, and Wix Media). Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio."
+            "description": "Embeds and plays audio content directly in a webpage. Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio."
           },
           "properties": {},
           "optionalProperties": {
@@ -5998,7 +6001,7 @@
             "features": [
               "FILE"
             ],
-            "description": "A digital file stored on a computer that is uploaded and accessed in a page. Files can include various types of content, such as text documents, images, videos, and so on."
+            "description": "File that is uploaded and accessed in a page. Files can be different types of content, such as text documents, images, and videos."
           },
           "properties": {
             "fileData": {
@@ -6036,7 +6039,7 @@
             "features": [
               "IMAGE"
             ],
-            "description": "Displays standalone pictures in a page."
+            "description": "Standalone images in a page."
           },
           "properties": {
             "imageData": {
@@ -6074,7 +6077,7 @@
             "features": [
               "VIDEO"
             ],
-            "description": "A multimedia node that is used to embed and play video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
+            "description": "Embeds and plays video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
           },
           "properties": {
             "videoData": {
@@ -6111,7 +6114,7 @@
             "features": [
               "GIF"
             ],
-            "description": "GIF images are made up of a series of frames, allowing them to display animations or short video clips without the need for additional plugins or technologies."
+            "description": "GIF images."
           },
           "properties": {
             "gifData": {
@@ -6148,7 +6151,7 @@
             "features": [
               "DIVIDER"
             ],
-            "description": "A visual node that is used to separate content sections in a page. When rendered, it is displayed as a horizontal line between the paragraphs, acting as a divider between them."
+            "description": "Horizontal line between different content."
           },
           "properties": {},
           "optionalProperties": {
@@ -6185,7 +6188,7 @@
               "code-block-multi-line",
               "code-block-syntax-highlighting"
             ],
-            "description": "Used to present programming code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
+            "description": "Presents code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
           },
           "properties": {},
           "optionalProperties": {
@@ -6213,7 +6216,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Code block styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             }
           }
@@ -6228,7 +6231,7 @@
             "features": [
               "HTML"
             ],
-            "description": "Incorporates external content, such as interactive maps, or entire web pages."
+            "description": "HTML block that incorporates external content, such as interactive maps or entire web pages."
           },
           "properties": {
             "htmlData": {
@@ -6265,7 +6268,7 @@
             "features": [
               "LINK_PREVIEW"
             ],
-            "description": "A preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and possibly a thumbnail image or other relevant information."
+            "description": "Preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and sometimes a thumbnail image or other relevant information."
           },
           "properties": {
             "linkPreviewData": {
@@ -6303,13 +6306,13 @@
             "features": [
               "APP_EMBED"
             ],
-            "description": "Similar to `LinkPreviewNode`, this node is used to embed external content preview, but from Wix business solutions. You can embed previews from the Wix Bookings, Wix Stores and Wix Events apps."
+            "description": "Embeds an external content preview from Wix business solutions. For example, you can embed previews from the Wix Bookings, Wix Stores and Wix Events apps."
           },
           "properties": {
             "appEmbedData": {
               "ref": "AppEmbedData",
               "metadata": {
-                "description": "Embedded Wix app details."
+                "description": "Embedded Wix app."
               }
             }
           },
@@ -6342,7 +6345,7 @@
             "features": [
               "BUTTON"
             ],
-            "description": "A node that is used to trigger an action when clicked or activated."
+            "description": "Button to trigger an action."
           },
           "properties": {
             "buttonData": {
@@ -6379,7 +6382,7 @@
             "features": [
               "EMBED"
             ],
-            "description": "Similar to `HtmlNode`, this node is used to display embedded content when you post a link to that resource, without having to parse the resource directly. It provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers without needing to handle the complex embedding code themselves. For more information, read [oembed](https://oembed.com/)."
+            "description": "Embedded content when you include a link to a resource, without having to parse the resource directly. This provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers. To learn more, see [oembed](https://oembed.com/)."
           },
           "properties": {
             "embedData": {
@@ -6413,7 +6416,7 @@
       "optionalProperties": {
         "cellStyle": {
           "metadata": {
-            "description": "Styling for the cell, such as background color and text alignment."
+            "description": "Cell styling."
           },
           "ref": "TableCellData_CellStyle"
         },
@@ -6432,7 +6435,7 @@
       "optionalProperties": {
         "verticalAlignment": {
           "metadata": {
-            "description": "Vertical alignment for the cell's text. Possible values: \n - `TOP`: Aligns the top padding edge of the cell with the top of the row. \n - `MIDDLE`: Centers the padding box of the cell in the row. \n - `BOTTOM`: Aligns the bottom padding edge of the cell with the bottom of the row.",
+            "description": "Vertical alignment for the cell's text.",
             "emitEnum": "TableCellData_VerticalAlignment"
           },
           "enum": [
@@ -6443,7 +6446,7 @@
         },
         "backgroundColor": {
           "metadata": {
-            "description": "Cell background color in a hexadecimal value, for example `#4287f5`.",
+            "description": "Cell background color as a hexadecimal value.",
             "format": "COLOR_HEX"
           },
           "type": "string"
@@ -6458,28 +6461,28 @@
         "left": {
           "metadata": {
             "format": "COLOR_HEX",
-            "description": "Left border color in a hexadecimal value."
+            "description": "Left border color as a hexadecimal value."
           },
           "type": "string"
         },
         "right": {
           "metadata": {
             "format": "COLOR_HEX",
-            "description": "Right border color in a hexadecimal value."
+            "description": "Right border color as a hexadecimal value."
           },
           "type": "string"
         },
         "top": {
           "metadata": {
             "format": "COLOR_HEX",
-            "description": "Top border color in a hexadecimal value."
+            "description": "Top border color as a hexadecimal value."
           },
           "type": "string"
         },
         "bottom": {
           "metadata": {
             "format": "COLOR_HEX",
-            "description": "Bottom border color in a hexadecimal value."
+            "description": "Bottom border color as a hexadecimal value."
           },
           "type": "string"
         }
@@ -6498,7 +6501,7 @@
         "features": [
           "VIDEO"
         ],
-        "description": "A multimedia node that is used to embed and play video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
+        "description": "Embeds and plays video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
       },
       "properties": {
         "type": {
@@ -6506,7 +6509,7 @@
             "VIDEO"
           ],
           "metadata": {
-            "description": "Node type. \n Value: `VIDEO`"
+            "description": "Node type. \n Must be `VIDEO`."
           }
         },
         "videoData": {
@@ -6538,7 +6541,7 @@
       "properties": {
         "video": {
           "metadata": {
-            "description": "Video file details, such as source and dimensions."
+            "description": "Video file details."
           },
           "ref": "Media"
         }
@@ -6546,13 +6549,13 @@
       "optionalProperties": {
         "containerData": {
           "metadata": {
-            "description": "Styling for the video container, such as dimensions and alignment."
+            "description": "Video container styling."
           },
           "ref": "PluginContainerData"
         },
         "thumbnail": {
           "metadata": {
-            "description": "Video thumbnail details, such as dimensions."
+            "description": "Video thumbnail details."
           },
           "ref": "Media"
         },
@@ -6608,7 +6611,7 @@
       "discriminator": "type",
       "metadata": {
         "section": "RootNode",
-        "description": "Represents nodes that can be added to the root level of `nodes` array.",
+        "description": "Nodes that can be added to the root level of `nodes` array.",
         "refUnion": {
           "PARAGRAPH": "ParagraphNode",
           "HEADING": "HeadingNode",
@@ -6637,7 +6640,7 @@
         "PARAGRAPH": {
           "metadata": {
             "section": "Paragraph",
-            "description": "Used to structure text content, providing a clear separation between different ideas or sections of text. They are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
+            "description": "Structures text content, providing a clear separation between different ideas or sections of text. Paragraphs are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content.",
             "examples": [
               "paragraph"
             ]
@@ -6662,7 +6665,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Paragraphs vertical padding. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Vertical padding. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "paragraphData": {
@@ -6679,7 +6682,7 @@
             "examples": [
               "headings-all-sizes"
             ],
-            "description": "Used to denote the heading or title of a section. Headings are hierarchical, with different levels indicating the relative importance of the heading in the content's structure. There are 6 levels of headings, where `1` is the highest level and `6` is the lowest."
+            "description": "Indicates a heading or title of a section. There are 6 levels of headings, with `1` being the most prominent and `6` being the least."
           },
           "properties": {},
           "optionalProperties": {
@@ -6701,7 +6704,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the heading style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Heading styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             },
             "headingData": {
@@ -6718,7 +6721,7 @@
             "examples": [
               "bulletedList"
             ],
-            "description": "Presents a group of items in a visually organized manner, where each item is preceded by a bullet point. Bulleted lists are commonly used to present unordered information."
+            "description": "Bulleted list."
           },
           "properties": {
             "nodes": {
@@ -6760,7 +6763,7 @@
             "examples": [
               "orderedList"
             ],
-            "description": "Presents a group of items in a sequentially numbered or lettered manner. Ordered lists are used to represent information that has a specific order or sequence."
+            "description": "Numbered list."
           },
           "properties": {
             "nodes": {
@@ -6802,7 +6805,7 @@
             "examples": [
               "blockquote"
             ],
-            "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it is displayed as the quoted text with indentation or other styling to visually separate it from the surrounding content."
+            "description": "Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it displays as the quoted text with indentation or other styling to visually separate it from the surrounding content."
           },
           "properties": {
             "nodes": {
@@ -6835,7 +6838,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             }
           }
@@ -6850,7 +6853,7 @@
               "code-block-multi-line",
               "code-block-syntax-highlighting"
             ],
-            "description": "Used to present programming code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
+            "description": "Presents code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code."
           },
           "properties": {},
           "optionalProperties": {
@@ -6878,7 +6881,7 @@
             "style": {
               "ref": "NodeStyle",
               "metadata": {
-                "description": "Defines the blockquote style, such as padding and background color. \n **Note:** This node requires the [lineSpacing](#plugins) plugin for styling."
+                "description": "Code block styling, such as padding and background color. \n **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled."
               }
             }
           }
@@ -6893,7 +6896,7 @@
             "features": [
               "VIDEO"
             ],
-            "description": "A multimedia node that is used to embed and play video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
+            "description": "Embeds and plays video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video."
           },
           "properties": {
             "videoData": {
@@ -6930,7 +6933,7 @@
             "features": [
               "DIVIDER"
             ],
-            "description": "A visual node that is used to separate content sections in a page. When rendered, it is displayed as a horizontal line between the paragraphs, acting as a divider between them."
+            "description": "Horizontal line between different content."
           },
           "properties": {},
           "optionalProperties": {
@@ -6966,7 +6969,7 @@
             "features": [
               "FILE"
             ],
-            "description": "A digital file stored on a computer that is uploaded and accessed in a page. Files can include various types of content, such as text documents, images, videos, and so on."
+            "description": "File that is uploaded and accessed in a page. Files can be different types of content, such as text documents, images, and videos."
           },
           "properties": {
             "fileData": {
@@ -7003,7 +7006,7 @@
             "features": [
               "GALLERY"
             ],
-            "description": "A collection of images displayed together in a visually appealing and organized manner."
+            "description": "Collection of images displayed together."
           },
           "properties": {
             "galleryData": {
@@ -7040,7 +7043,7 @@
             "features": [
               "GIF"
             ],
-            "description": "GIF images are made up of a series of frames, allowing them to display animations or short video clips without the need for additional plugins or technologies."
+            "description": "GIF images."
           },
           "properties": {
             "gifData": {
@@ -7078,7 +7081,7 @@
             "features": [
               "HTML"
             ],
-            "description": "Incorporates external content, such as interactive maps, or entire web pages."
+            "description": "HTML block that incorporates external content, such as interactive maps or entire web pages."
           },
           "properties": {
             "htmlData": {
@@ -7116,7 +7119,7 @@
             "features": [
               "IMAGE"
             ],
-            "description": "Displays standalone pictures in a page."
+            "description": "Standalone images in a page."
           },
           "properties": {
             "imageData": {
@@ -7153,7 +7156,7 @@
             "features": [
               "LINK_PREVIEW"
             ],
-            "description": "A preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and possibly a thumbnail image or other relevant information."
+            "description": "Preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and sometimes a thumbnail image or other relevant information."
           },
           "properties": {
             "linkPreviewData": {
@@ -7190,7 +7193,7 @@
             "features": [
               "POLL"
             ],
-            "description": "A node that allows users to vote or express their opinions on a particular question, topic, or issue."
+            "description": "Provides a question with several options, where the options' cumulative total may be shown."
           },
           "properties": {
             "pollData": {
@@ -7228,13 +7231,13 @@
             "features": [
               "APP_EMBED"
             ],
-            "description": "Similar to `LinkPreviewNode`, this node is used to embed external content preview, but from Wix business solutions. You can embed previews from the Wix Bookings, Wix Stores and Wix Events apps."
+            "description": "Embeds an external content preview from Wix business solutions. For example, you can embed previews from the Wix Bookings, Wix Stores and Wix Events apps."
           },
           "properties": {
             "appEmbedData": {
               "ref": "AppEmbedData",
               "metadata": {
-                "description": "Embedded Wix app details."
+                "description": "Embedded Wix app."
               }
             }
           },
@@ -7267,7 +7270,7 @@
             "features": [
               "BUTTON"
             ],
-            "description": "A node that is used to trigger an action when clicked or activated."
+            "description": "Button to trigger an action."
           },
           "properties": {
             "buttonData": {
@@ -7304,7 +7307,7 @@
             "features": [
               "COLLAPSIBLE_LIST"
             ],
-            "description": "A list of items where each item can be expanded or collapsed to reveal or hide additional content associated with it."
+            "description": "List of items where each item can be expanded or collapsed."
           },
           "properties": {
             "nodes": {
@@ -7344,7 +7347,7 @@
             "features": [
               "TABLE"
             ],
-            "description": "A structural node used to display data in rows and columns."
+            "description": "Data in rows and columns."
           },
           "properties": {
             "nodes": {
@@ -7384,7 +7387,7 @@
             "features": [
               "EMBED"
             ],
-            "description": "Similar to `HtmlNode`, this node is used to display embedded content when you post a link to that resource, without having to parse the resource directly. It provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers without needing to handle the complex embedding code themselves. For more information, read [oembed](https://oembed.com/)."
+            "description": "Embedded content when you include a link to a resource, without having to parse the resource directly. This provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers. To learn more, see [oembed](https://oembed.com/)."
           },
           "properties": {
             "embedData": {
@@ -7421,7 +7424,7 @@
             "features": [
               "AUDIO"
             ],
-            "description": "A multimedia node used to embed and play audio content directly in a webpage. When rendered, it is displayed as the audio player with the specified audio file (can be a platform such as Spotify or Soundloud, and Wix Media). Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio."
+            "description": "Embeds and plays audio content directly in a webpage. Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio."
           },
           "properties": {},
           "optionalProperties": {