mdui 2.1.4 → 2.1.5

package/html-data.en.json

@@ -17,19 +17,19 @@
         },
         {
           "name": "fit",
-          "description": "Image resizing method, similar to the native CSS [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit). Possible values:\n\n* `contain`: Scales the image to fit within the box while maintaining the aspect ratio. The image will be \"letterboxed\" if the aspect ratios do not match.\n* `cover`: Scales the image to fill the box while maintaining the aspect ratio. The image will be clipped if the aspect ratios do not match.\n* `fill`: Default. Scales the image to fill the box. The image will be stretched if the aspect ratios do not match.\n* `none`: No resizing.\n* `scale-down`: Scales as if `none` or `contain` were specified, choosing the smaller result.",
+          "description": "Image resizing method, similar to the CSS [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) property. Possible values:\n\n* `contain`: Scales the image to fit within the box while preserving aspect ratio. The image will be \"letterboxed\" if the aspect ratios do not match.\n* `cover`: Scales the image to fill the box while preserving aspect ratio. The image will be clipped if the aspect ratios do not match.\n* `fill`: Default. Scales the image to fill the box; the image may be stretched if aspect ratios do not match.\n* `none`: No resizing.\n* `scale-down`: Scales the image down to fit. Behaves like `none` or `contain`, whichever results in the smaller image.",
           "values": [
             {
               "name": "contain",
-              "description": "Scales the image to fit within the box while maintaining the aspect ratio. The image will be \"letterboxed\" if the aspect ratios do not match."
+              "description": "Scales the image to fit within the box while preserving aspect ratio. The image will be \"letterboxed\" if the aspect ratios do not match."
             },
             {
               "name": "cover",
-              "description": "Scales the image to fill the box while maintaining the aspect ratio. The image will be clipped if the aspect ratios do not match."
+              "description": "Scales the image to fill the box while preserving aspect ratio. The image will be clipped if the aspect ratios do not match."
             },
             {
               "name": "fill",
-              "description": "Default. Scales the image to fill the box. The image will be stretched if the aspect ratios do not match."
+              "description": "Default. Scales the image to fill the box; the image may be stretched if aspect ratios do not match."
             },
             {
               "name": "none",
@@ -37,7 +37,7 @@
             },
             {
               "name": "scale-down",
-              "description": "Scales as if `none` or `contain` were specified, choosing the smaller result."
+              "description": "Scales the image down to fit. Behaves like `none` or `contain`, whichever results in the smaller image."
             }
           ],
           "references": [
@@ -85,7 +85,7 @@
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the badge shape. Possible values:\n* `small`: A small badge without text.\n* `large`: A large badge with displayed text.",
+          "description": "Defines the badge size. Possible values:\n* `small`: A small badge without text.\n* `large`: A large badge with text.",
           "values": [
             {
               "name": "small",
@@ -93,7 +93,7 @@
             },
             {
               "name": "large",
-              "description": "A large badge with displayed text."
+              "description": "A large badge with text."
             }
           ],
           "references": [
@@ -121,7 +121,7 @@
       "attributes": [
         {
           "name": "hide",
-          "description": "Hides the bottom app bar when set.",
+          "description": "Whether the bottom app bar is hidden.",
           "references": [
             {
               "name": "Docs",
@@ -131,7 +131,7 @@
         },
         {
           "name": "fab-detach",
-          "description": "When set, detaches the [`<mdui-fab>`](https://www.mdui.org/en/docs/2/components/fab) from the bottom app bar. The [`<mdui-fab>`](https://www.mdui.org/en/docs/2/components/fab) remains on the page even after the app bar is hidden.",
+          "description": "If set, detaches the [`<mdui-fab>`](/en/docs/2/components/fab) from the bottom app bar. The [`<mdui-fab>`](/en/docs/2/components/fab) remains on the page even after the app bar is hidden.",
           "references": [
             {
               "name": "Docs",
@@ -141,7 +141,7 @@
         },
         {
           "name": "scroll-behavior",
-          "description": "Defines the scroll behavior. Possible values:\n\n* `hide`: Hides when scrolling.",
+          "description": "Specifies the scroll behavior. Possible values:\n\n* `hide`: Hides when scrolling.",
           "values": [
             {
               "name": "hide"
@@ -162,7 +162,7 @@
         },
         {
           "name": "scroll-target",
-          "description": "The element that listens for scroll events. Accepts a CSS selector, DOM element, or [JQ object](https://www.mdui.org/en/docs/2/functions/jq). Defaults to `window`.",
+          "description": "The element to watch for scroll events. Accepts a CSS selector, a DOM element, or a [JQ object](/en/docs/2/functions/jq). Defaults to `window`.",
           "references": [
             {
               "name": "Docs",
@@ -172,7 +172,7 @@
         },
         {
           "name": "scroll-threshold",
-          "description": "The scroll distance (in pixels) that triggers the scroll behavior.",
+          "description": "The scroll distance (in pixels) required to trigger the scroll behavior.",
           "references": [
             {
               "name": "Docs",
@@ -182,7 +182,7 @@
         },
         {
           "name": "order",
-          "description": "Specifies the layout order within the [`<mdui-layout>`](https://www.mdui.org/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
+          "description": "Specifies the layout order within the [`<mdui-layout>`](/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
           "references": [
             {
               "name": "Docs",
@@ -208,7 +208,7 @@
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the icon button style. Possible values:\n* `standard`: For low-priority actions.\n* `filled`: Has the strongest visual effect, suitable for high-priority actions.\n* `tonal`: A visual effect between `filled` and `outlined`, suitable for medium to high-priority actions.\n* `outlined`: For medium-priority actions.",
+          "description": "Defines the icon button variant. Possible values:\n* `standard`: For low-priority actions.\n* `filled`: Has the strongest visual emphasis and works well for high-priority actions.\n* `tonal`: Blends `filled` and `outlined`, and works well for medium- to high-priority actions.\n* `outlined`: For medium-priority or secondary actions.",
           "values": [
             {
               "name": "standard",
@@ -220,11 +220,11 @@
             },
             {
               "name": "tonal",
-              "description": "A visual effect between `filled` and `outlined`, suitable for medium to high-priority actions."
+              "description": "A blend of `filled` and `outlined`, suitable for medium- to high-priority actions."
             },
             {
               "name": "outlined",
-              "description": "For medium-priority actions."
+              "description": "For medium-priority or secondary actions."
             }
           ],
           "references": [
@@ -256,7 +256,7 @@
         },
         {
           "name": "selectable",
-          "description": "Indicates if the button is selectable.",
+          "description": "Makes the button selectable.",
           "references": [
             {
               "name": "Docs",
@@ -266,7 +266,7 @@
         },
         {
           "name": "selected",
-          "description": "Indicates if the button is selected.",
+          "description": "Indicates whether the button is selected.",
           "references": [
             {
               "name": "Docs",
@@ -276,7 +276,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If specified, the component renders as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -286,7 +286,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to treat the linked URL as a download.\n\n**Note**:  This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -296,7 +296,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to display the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent exists.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors exist.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -304,15 +304,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent exists."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors exist."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -324,19 +324,19 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: Author of the current document or article.\n* `bookmark`: Permanent link for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: Link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary one (i.e., when `target=\"_blank\"`).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
-              "description": "Author of the current document or article."
+              "description": "The author of the current document or article."
             },
             {
               "name": "bookmark",
-              "description": "Permanent link for the nearest ancestor section."
+              "description": "The permalink for the nearest ancestor section."
             },
             {
               "name": "external",
@@ -344,7 +344,7 @@
             },
             {
               "name": "help",
-              "description": "Link to context-sensitive help."
+              "description": "A link to context-sensitive help."
             },
             {
               "name": "license",
@@ -356,7 +356,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -364,15 +364,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -380,7 +380,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -392,7 +392,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -402,7 +402,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -432,7 +432,7 @@
         },
         {
           "name": "name",
-          "description": "The button's name, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button name submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -442,7 +442,7 @@
         },
         {
           "name": "value",
-          "description": "The button's value, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button value submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -452,7 +452,7 @@
         },
         {
           "name": "type",
-          "description": "Defines the button's default behavior. The default is `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Resets all the controls to their initial values.\n* `button`: No default behavior, does nothing when pressed by default.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "Specifies the button's default action. Default: `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Restores all controls to their initial values.\n* `button`: Does nothing by default.\n\n**Note**: Only available when `href` is not specified.",
           "values": [
             {
               "name": "submit",
@@ -460,11 +460,11 @@
             },
             {
               "name": "reset",
-              "description": "Resets all the controls to their initial values."
+              "description": "Resets all controls to their initial values."
             },
             {
               "name": "button",
-              "description": "No default behavior, does nothing when pressed by default."
+              "description": "Has no default action."
             }
           ],
           "references": [
@@ -476,7 +476,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the button with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the button is associated with its parent `<form>`, if any.\n\nThis attribute allows button elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.\n\n**Note**: Only available when `href` is not specified.",
+          "description": "Associates the button with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the button uses its parent `<form>`, if any.\n\nThis lets the button target any form in the document, not just the one it is nested in.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -496,7 +496,7 @@
         },
         {
           "name": "formenctype",
-          "description": "Specifies the form data encoding method. Possible values:\n\n* `application/x-www-form-urlencoded`: Default if the attribute is not used.\n* `multipart/form-data`: Used for `<input>` elements with `type` set to `file`.\n* `text/plain`: For debugging, not for real form submission.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies how to encode the form data. Possible values:\n\n* `application/x-www-form-urlencoded`: Default when the attribute is omitted.\n* `multipart/form-data`: Used for `<input>` elements with `type=\"file\"`.\n* `text/plain`: Useful for debugging, but not for actual form submissions.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "application/x-www-form-urlencoded",
@@ -504,7 +504,7 @@
             },
             {
               "name": "multipart/form-data",
-              "description": "Used for `<input>` elements with `type` set to `file`."
+              "description": "Used for `<input>` elements with `type=\"file\"`."
             },
             {
               "name": "text/plain",
@@ -520,15 +520,15 @@
         },
         {
           "name": "formmethod",
-          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Form data included in HTTP request body.\n* `get`: Form data appended to `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Sends the form data in the request body.\n* `get`: Appends the form data to the `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "post",
-              "description": "Form data included in HTTP request body."
+              "description": "Form data is included in the HTTP request body."
             },
             {
               "name": "get",
-              "description": "Form data appended to `action` URL."
+              "description": "Form data is appended to the `action` URL."
             }
           ],
           "references": [
@@ -550,11 +550,11 @@
         },
         {
           "name": "formtarget",
-          "description": "Specifies where to display the form submission response. Possible values:\n\n* `_self`: Current browsing context. (Default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context or `_self` if no parent.\n* `_top`: Topmost browsing context or `_self` if no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies where to open the response after form submission. Possible values:\n\n* `_self`: Current browsing context (default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context, or `_self` if there is no parent.\n* `_top`: Topmost browsing context, or `_self` if there are no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "_self",
-              "description": "Current browsing context. (Default)."
+              "description": "Current browsing context (default)."
             },
             {
               "name": "_blank",
@@ -562,11 +562,11 @@
             },
             {
               "name": "_parent",
-              "description": "Parent browsing context or `_self` if no parent."
+              "description": "Parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_top",
-              "description": "Topmost browsing context or `_self` if no ancestors."
+              "description": "Topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -594,11 +594,11 @@
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the button style. Possible values:\n* `elevated`: A shadowed button for visual distinction.\n* `filled`: Used for final actions like 'Save' or 'Confirm'.\n* `tonal`: A mix between `filled` and `outlined`, suitable for medium to high-priority actions.\n* `outlined`: A bordered button for medium-priority and secondary actions.\n* `text`: A text button for low-priority actions.",
+          "description": "Defines the button variant. Possible values:\n* `elevated`: A button with a shadow for visual emphasis.\n* `filled`: Used for final actions like 'Save' or 'Confirm'.\n* `tonal`: Blends `filled` and `outlined`, and works well for medium- to high-priority actions.\n* `outlined`: A bordered button for medium-priority and secondary actions.\n* `text`: A text button for low-priority actions.",
           "values": [
             {
               "name": "elevated",
-              "description": "A shadowed button for visual distinction."
+              "description": "A button with a shadow for visual emphasis."
             },
             {
               "name": "filled",
@@ -606,7 +606,7 @@
             },
             {
               "name": "tonal",
-              "description": "A mix between `filled` and `outlined`, suitable for medium to high-priority actions."
+              "description": "A blend of `filled` and `outlined`, suitable for medium- to high-priority actions."
             },
             {
               "name": "outlined",
@@ -626,7 +626,7 @@
         },
         {
           "name": "full-width",
-          "description": "If set, the button will fill the width of its parent element.",
+          "description": "If set, the button expands to fill the width of its container.",
           "references": [
             {
               "name": "Docs",
@@ -656,7 +656,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If provided, the component is rendered as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -666,7 +666,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to download the linked URL.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -676,7 +676,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to open the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -684,15 +684,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -704,11 +704,11 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary one (i.e., when `target=\"_blank\"`).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
@@ -736,7 +736,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -744,15 +744,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -760,7 +760,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -772,7 +772,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Specifies that the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -782,7 +782,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Defines the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -812,7 +812,7 @@
         },
         {
           "name": "name",
-          "description": "The button's name, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button name submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -822,7 +822,7 @@
         },
         {
           "name": "value",
-          "description": "The button's value, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button value submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -832,7 +832,7 @@
         },
         {
           "name": "type",
-          "description": "Defines the button's default behavior. The default is `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Resets all the controls to their initial values.\n* `button`: No default behavior, does nothing when pressed by default.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "Specifies the button's default action. Default: `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Restores all controls to their initial values.\n* `button`: Does nothing by default.\n\n**Note**: Only available when `href` is not specified.",
           "values": [
             {
               "name": "submit",
@@ -840,11 +840,11 @@
             },
             {
               "name": "reset",
-              "description": "Resets all the controls to their initial values."
+              "description": "Resets all controls to their initial values."
             },
             {
               "name": "button",
-              "description": "No default behavior, does nothing when pressed by default."
+              "description": "Has no default action."
             }
           ],
           "references": [
@@ -856,7 +856,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the button with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the button is associated with its parent `<form>`, if any.\n\nThis attribute allows button elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.\n\n**Note**: Only available when `href` is not specified.",
+          "description": "Associates the button with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the button uses its parent `<form>`, if any.\n\nThis lets the button target any form in the document, not just the one it is nested in.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -876,7 +876,7 @@
         },
         {
           "name": "formenctype",
-          "description": "Specifies the form data encoding method. Possible values:\n\n* `application/x-www-form-urlencoded`: Default if the attribute is not used.\n* `multipart/form-data`: Used for `<input>` elements with `type` set to `file`.\n* `text/plain`: For debugging, not for real form submission.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies how to encode the form data. Possible values:\n\n* `application/x-www-form-urlencoded`: Default when the attribute is omitted.\n* `multipart/form-data`: Used for `<input>` elements with `type=\"file\"`.\n* `text/plain`: Useful for debugging, but not for actual form submissions.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "application/x-www-form-urlencoded",
@@ -884,7 +884,7 @@
             },
             {
               "name": "multipart/form-data",
-              "description": "Used for `<input>` elements with `type` set to `file`."
+              "description": "Used for `<input>` elements with `type=\"file\"`."
             },
             {
               "name": "text/plain",
@@ -900,15 +900,15 @@
         },
         {
           "name": "formmethod",
-          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Form data included in HTTP request body.\n* `get`: Form data appended to `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Sends the form data in the request body.\n* `get`: Appends the form data to the `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "post",
-              "description": "Form data included in HTTP request body."
+              "description": "Form data is included in the HTTP request body."
             },
             {
               "name": "get",
-              "description": "Form data appended to `action` URL."
+              "description": "Form data is appended to the `action` URL."
             }
           ],
           "references": [
@@ -930,11 +930,11 @@
         },
         {
           "name": "formtarget",
-          "description": "Specifies where to display the form submission response. Possible values:\n\n* `_self`: Current browsing context. (Default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context or `_self` if no parent.\n* `_top`: Topmost browsing context or `_self` if no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies where to open the response after form submission. Possible values:\n\n* `_self`: Current browsing context (default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context, or `_self` if there is no parent.\n* `_top`: Topmost browsing context, or `_self` if there are no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "_self",
-              "description": "Current browsing context. (Default)."
+              "description": "Current browsing context (default)."
             },
             {
               "name": "_blank",
@@ -942,11 +942,11 @@
             },
             {
               "name": "_parent",
-              "description": "Parent browsing context or `_self` if no parent."
+              "description": "Parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_top",
-              "description": "Topmost browsing context or `_self` if no ancestors."
+              "description": "Topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -974,7 +974,7 @@
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the card style. Possible values:\n* `elevated`: Shadowed, providing more visual separation from the background than `filled`, but less than `outlined`.\n* `filled`: Provides minimal visual separation from the background.\n* `outlined`: Bordered, providing maximum visual separation from the background.",
+          "description": "Defines the card variant. Possible values:\n* `elevated`: Shadowed, offering more separation from the background than `filled`, but less than `outlined`.\n* `filled`: Provides minimal separation from the background.\n* `outlined`: Bordered, providing the most separation from the background.",
           "values": [
             {
               "name": "elevated",
@@ -998,7 +998,7 @@
         },
         {
           "name": "clickable",
-          "description": "Makes the card clickable. When set, a mouse hover effect and click ripple effect are added.",
+          "description": "Makes the card clickable. If set, hover and click ripple effects are added.",
           "references": [
             {
               "name": "Docs",
@@ -1018,7 +1018,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If specified, the component renders as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -1028,7 +1028,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to treat the linked URL as a download.\n\n**Note**:  This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -1038,7 +1038,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to display the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent exists.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors exist.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -1046,15 +1046,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent exists."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors exist."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -1066,19 +1066,19 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: Author of the current document or article.\n* `bookmark`: Permanent link for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: Link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
-              "description": "Author of the current document or article."
+              "description": "The author of the current document or article."
             },
             {
               "name": "bookmark",
-              "description": "Permanent link for the nearest ancestor section."
+              "description": "The permalink for the nearest ancestor section."
             },
             {
               "name": "external",
@@ -1086,7 +1086,7 @@
             },
             {
               "name": "help",
-              "description": "Link to context-sensitive help."
+              "description": "A link to context-sensitive help."
             },
             {
               "name": "license",
@@ -1098,7 +1098,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -1106,15 +1106,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -1122,7 +1122,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -1134,7 +1134,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -1144,7 +1144,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -1170,7 +1170,7 @@
       "attributes": [
         {
           "name": "disabled",
-          "description": "Dsiables the checkbox.",
+          "description": "Disables the checkbox.",
           "references": [
             {
               "name": "Docs",
@@ -1200,7 +1200,7 @@
         },
         {
           "name": "required",
-          "description": "Requires the checkbox to be checked for form submission.",
+          "description": "The checkbox must be checked to submit the form.",
           "references": [
             {
               "name": "Docs",
@@ -1210,7 +1210,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the checkbox with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the checkbox is associated with its parent `<form>`, if any.\n\nThis attribute allows checkbox elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.",
+          "description": "Associates the checkbox with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the checkbox uses its parent `<form>`, if any.\n\nThis lets the checkbox work with any form in the document, not just the one it is nested in.",
           "references": [
             {
               "name": "Docs",
@@ -1270,7 +1270,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -1280,7 +1280,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -1306,23 +1306,23 @@
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the chip type. Possible values:\n\n* `assist`: Displays auxiliary actions related to the context, such as sharing and favoriting on a meal ordering page.\n* `filter`: Filters content, like search results on a search results page.\n* `input`: Represents fragments of user input, such as contacts in the 'To' field in Gmail.\n* `suggestion`: Provides dynamically generated suggestions to simplify user actions, like message predictions in a chat application.",
+          "description": "Defines the chip variant. Possible values:\n\n* `assist`: Shows contextual actions, such as sharing or favoriting on a meal-ordering page.\n* `filter`: Filters content, such as search results.\n* `input`: Represents user input, such as contacts in Gmail's 'To' field.\n* `suggestion`: Shows dynamic suggestions that help users act more quickly, such as message suggestions in a chat app.",
           "values": [
             {
               "name": "assist",
-              "description": "Displays auxiliary actions related to the context, such as sharing and favoriting on a meal ordering page."
+              "description": "Shows contextual actions, such as sharing or favoriting on a meal-ordering page."
             },
             {
               "name": "filter",
-              "description": "Filters content, like search results on a search results page."
+              "description": "Filters content, such as search results."
             },
             {
               "name": "input",
-              "description": "Represents fragments of user input, such as contacts in the 'To' field in Gmail."
+              "description": "Represents user input, such as contacts in Gmail's 'To' field."
             },
             {
               "name": "suggestion",
-              "description": "Provides dynamically generated suggestions to simplify user actions, like message predictions in a chat application."
+              "description": "Shows dynamic suggestions that help users act more quickly, such as message suggestions in a chat app."
             }
           ],
           "references": [
@@ -1334,7 +1334,7 @@
         },
         {
           "name": "elevated",
-          "description": "Gives the chip a shadow.",
+          "description": "Adds a shadow to the chip.",
           "references": [
             {
               "name": "Docs",
@@ -1364,7 +1364,7 @@
         },
         {
           "name": "deletable",
-          "description": "Makes the chip deletable. When set, a delete icon appears on the right.",
+          "description": "Makes the chip deletable. If set, a delete icon appears on the right.",
           "references": [
             {
               "name": "Docs",
@@ -1414,7 +1414,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If provided, the component is rendered as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -1424,7 +1424,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to download the linked URL.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -1434,7 +1434,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to open the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -1442,15 +1442,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -1462,11 +1462,11 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary one (i.e., when `target=\"_blank\"`).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
@@ -1494,7 +1494,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -1502,15 +1502,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -1518,7 +1518,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -1530,7 +1530,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Specifies that the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -1540,7 +1540,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Defines the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -1570,7 +1570,7 @@
         },
         {
           "name": "name",
-          "description": "The button's name, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button name submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -1580,7 +1580,7 @@
         },
         {
           "name": "value",
-          "description": "The button's value, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button value submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -1590,7 +1590,7 @@
         },
         {
           "name": "type",
-          "description": "Defines the button's default behavior. The default is `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Resets all the controls to their initial values.\n* `button`: No default behavior, does nothing when pressed by default.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "Specifies the button's default action. Default: `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Restores all controls to their initial values.\n* `button`: Does nothing by default.\n\n**Note**: Only available when `href` is not specified.",
           "values": [
             {
               "name": "submit",
@@ -1598,11 +1598,11 @@
             },
             {
               "name": "reset",
-              "description": "Resets all the controls to their initial values."
+              "description": "Resets all controls to their initial values."
             },
             {
               "name": "button",
-              "description": "No default behavior, does nothing when pressed by default."
+              "description": "Has no default action."
             }
           ],
           "references": [
@@ -1614,7 +1614,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the button with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the button is associated with its parent `<form>`, if any.\n\nThis attribute allows button elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.\n\n**Note**: Only available when `href` is not specified.",
+          "description": "Associates the button with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the button uses its parent `<form>`, if any.\n\nThis lets the button target any form in the document, not just the one it is nested in.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -1634,7 +1634,7 @@
         },
         {
           "name": "formenctype",
-          "description": "Specifies the form data encoding method. Possible values:\n\n* `application/x-www-form-urlencoded`: Default if the attribute is not used.\n* `multipart/form-data`: Used for `<input>` elements with `type` set to `file`.\n* `text/plain`: For debugging, not for real form submission.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies how to encode the form data. Possible values:\n\n* `application/x-www-form-urlencoded`: Default when the attribute is omitted.\n* `multipart/form-data`: Used for `<input>` elements with `type=\"file\"`.\n* `text/plain`: Useful for debugging, but not for actual form submissions.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "application/x-www-form-urlencoded",
@@ -1642,7 +1642,7 @@
             },
             {
               "name": "multipart/form-data",
-              "description": "Used for `<input>` elements with `type` set to `file`."
+              "description": "Used for `<input>` elements with `type=\"file\"`."
             },
             {
               "name": "text/plain",
@@ -1658,15 +1658,15 @@
         },
         {
           "name": "formmethod",
-          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Form data included in HTTP request body.\n* `get`: Form data appended to `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Sends the form data in the request body.\n* `get`: Appends the form data to the `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "post",
-              "description": "Form data included in HTTP request body."
+              "description": "Form data is included in the HTTP request body."
             },
             {
               "name": "get",
-              "description": "Form data appended to `action` URL."
+              "description": "Form data is appended to the `action` URL."
             }
           ],
           "references": [
@@ -1688,11 +1688,11 @@
         },
         {
           "name": "formtarget",
-          "description": "Specifies where to display the form submission response. Possible values:\n\n* `_self`: Current browsing context. (Default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context or `_self` if no parent.\n* `_top`: Topmost browsing context or `_self` if no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies where to open the response after form submission. Possible values:\n\n* `_self`: Current browsing context (default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context, or `_self` if there is no parent.\n* `_top`: Topmost browsing context, or `_self` if there are no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "_self",
-              "description": "Current browsing context. (Default)."
+              "description": "Current browsing context (default)."
             },
             {
               "name": "_blank",
@@ -1700,11 +1700,11 @@
             },
             {
               "name": "_parent",
-              "description": "Parent browsing context or `_self` if no parent."
+              "description": "Parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_top",
-              "description": "Topmost browsing context or `_self` if no ancestors."
+              "description": "Topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -1764,7 +1764,7 @@
     },
     {
       "name": "mdui-collapse-item",
-      "description": "Collapse Item Component  It should be used in conjunction with the `<mdui-collapse>` component \n\n```html\n<mdui-collapse>\n  <mdui-collapse-item header=\"header-1\">content-1</mdui-collapse-item>\n  <mdui-collapse-item header=\"header-2\">content-2</mdui-collapse-item>\n</mdui-collapse>\n```",
+      "description": "Collapse Item Component  Use with the `<mdui-collapse>` component \n\n```html\n<mdui-collapse>\n  <mdui-collapse-item header=\"header-1\">content-1</mdui-collapse-item>\n  <mdui-collapse-item header=\"header-2\">content-2</mdui-collapse-item>\n</mdui-collapse>\n```",
       "attributes": [
         {
           "name": "value",
@@ -1798,7 +1798,7 @@
         },
         {
           "name": "trigger",
-          "description": "Identifies the element that triggers the collapse on click. This can be a CSS selector, a DOM element, or a [JQ object](https://www.mdui.org/en/docs/2/functions/jq). By default, the entire header area is the trigger.",
+          "description": "The element that toggles collapse on click. This can be a CSS selector, a DOM element, or a [JQ object](/en/docs/2/functions/jq). By default, the entire header area is the trigger.",
           "references": [
             {
               "name": "Docs",
@@ -1820,7 +1820,7 @@
     },
     {
       "name": "mdui-collapse",
-      "description": "Collapse Panel Component  It should be used in conjunction with the `<mdui-collapse-item>` component \n\n```html\n<mdui-collapse>\n  <mdui-collapse-item header=\"header-1\">content-1</mdui-collapse-item>\n  <mdui-collapse-item header=\"header-2\">content-2</mdui-collapse-item>\n</mdui-collapse>\n```",
+      "description": "Collapse Panel Component  Use with the `<mdui-collapse-item>` component \n\n```html\n<mdui-collapse>\n  <mdui-collapse-item header=\"header-1\">content-1</mdui-collapse-item>\n  <mdui-collapse-item header=\"header-2\">content-2</mdui-collapse-item>\n</mdui-collapse>\n```",
       "attributes": [
         {
           "name": "accordion",
@@ -1834,7 +1834,7 @@
         },
         {
           "name": "value",
-          "description": "Specifies the open `<mdui-collapse-item>` value.\n\nNote: The HTML attribute is always a string and can only be initially set when `accordion` is `true`. The JavaScript property value is a string when `accordion` is `true` and a string array when `accordion` is `false`. To modify this value when `accordion` is `false`, you must change the JavaScript property.",
+          "description": "Specifies the open `<mdui-collapse-item>` value.\n\n**Note**: The HTML attribute is always a string and can only be set initially when `accordion` is `true`. The JavaScript property is a string when `accordion` is `true` and a string array when `accordion` is `false`. To change this value when `accordion` is `false`, update the JavaScript property.",
           "references": [
             {
               "name": "Docs",
@@ -1890,7 +1890,7 @@
         },
         {
           "name": "description",
-          "description": "Sets the text below the title. Alternatively, use `slot=\"description\"`.",
+          "description": "The text displayed below the title. Alternatively, use `slot=\"description\"`.",
           "references": [
             {
               "name": "Docs",
@@ -1910,7 +1910,7 @@
         },
         {
           "name": "fullscreen",
-          "description": "Sets the dialog to full-screen.",
+          "description": "Displays the dialog in full-screen mode.",
           "references": [
             {
               "name": "Docs",
@@ -2032,23 +2032,23 @@
         },
         {
           "name": "trigger",
-          "description": "Defines the trigger method for the dropdown. Supports multiple space-separated values. Possible values:\n\n* `click`: Trigger on click.\n* `hover`: Trigger on mouse hover.\n* `focus`: Trigger on focus.\n* `contextmenu`: Trigger on right-click or touch long press.\n* `manual`: If used, the dropdown can only be opened and closed programmatically, and no other trigger methods can be specified.",
+          "description": "Defines how the dropdown opens. Multiple space-separated values are supported. Possible values:\n\n* `click`: Triggers on click.\n* `hover`: Triggers on mouse hover.\n* `focus`: Triggers on focus.\n* `contextmenu`: Triggers on right-click or long press.\n* `manual`: If used, the dropdown can only be opened and closed programmatically, and no other trigger methods can be specified.",
           "values": [
             {
               "name": "click",
-              "description": "Trigger on click."
+              "description": "Triggers on click."
             },
             {
               "name": "hover",
-              "description": "Trigger on mouse hover."
+              "description": "Triggers on mouse hover."
             },
             {
               "name": "focus",
-              "description": "Trigger on focus."
+              "description": "Triggers on focus."
             },
             {
               "name": "contextmenu",
-              "description": "Trigger on right-click or touch long press."
+              "description": "Triggers on right-click or long press."
             },
             {
               "name": "manual",
@@ -2064,11 +2064,11 @@
         },
         {
           "name": "placement",
-          "description": "Sets the position of the dropdown. Possible values:\n\n* `auto`: Automatically determine the position.\n* `top-start`: Above and left-aligned.\n* `top`: Above and centered.\n* `top-end`: Above and right-aligned.\n* `bottom-start`: Below and left-aligned.\n* `bottom`: Below and centered.\n* `bottom-end`: Below and right-aligned.\n* `left-start`: Left and top-aligned.\n* `left`: Left and centered.\n* `left-end`: Left and bottom-aligned.\n* `right-start`: Right and top-aligned.\n* `right`: Right and centered.\n* `right-end`: Right and bottom-aligned.",
+          "description": "Sets the dropdown position. Possible values:\n\n* `auto`: Automatically determined.\n* `top-start`: Above and left-aligned.\n* `top`: Above and centered.\n* `top-end`: Above and right-aligned.\n* `bottom-start`: Below and left-aligned.\n* `bottom`: Below and centered.\n* `bottom-end`: Below and right-aligned.\n* `left-start`: Left and top-aligned.\n* `left`: Left and centered.\n* `left-end`: Left and bottom-aligned.\n* `right-start`: Right and top-aligned.\n* `right`: Right and centered.\n* `right-end`: Right and bottom-aligned.",
           "values": [
             {
               "name": "auto",
-              "description": "Automatically determine the position."
+              "description": "Automatically determined."
             },
             {
               "name": "top-start",
@@ -2128,7 +2128,7 @@
         },
         {
           "name": "stay-open-on-click",
-          "description": "Keeps the dropdown open after clicking an [`<mdui-menu-item>`](https://www.mdui.org/en/docs/2/components/menu#menu-item-api).",
+          "description": "Prevents the dropdown from closing when a [`<mdui-menu-item>`](/en/docs/2/components/menu#menu-item-api) is clicked.",
           "references": [
             {
               "name": "Docs",
@@ -2158,7 +2158,7 @@
         },
         {
           "name": "open-on-pointer",
-          "description": "Opens the dropdown at the cursor position. This is typically used for context menus.",
+          "description": "Opens the dropdown at the pointer position. This is typically used for context menus.",
           "references": [
             {
               "name": "Docs",
@@ -2212,19 +2212,19 @@
         },
         {
           "name": "size",
-          "description": "Sets the FAB size. Possible values:\n* `normal`: Sets the FAB to a normal size.\n* `small`: Sets the FAB to a small size.\n* `large`: Sets the FAB to a large size.",
+          "description": "Sets the FAB size. Possible values:\n* `normal`: Normal size.\n* `small`: Small size.\n* `large`: Large size.",
           "values": [
             {
               "name": "normal",
-              "description": "Sets the FAB to a normal size."
+              "description": "Normal size."
             },
             {
               "name": "small",
-              "description": "Sets the FAB to a small size."
+              "description": "Small size."
             },
             {
               "name": "large",
-              "description": "Sets the FAB to a large size."
+              "description": "Large size."
             }
           ],
           "references": [
@@ -2246,7 +2246,7 @@
         },
         {
           "name": "extended",
-          "description": "Indicates if the FAB is in the extended state.",
+          "description": "Extends the FAB to show text alongside the icon.",
           "references": [
             {
               "name": "Docs",
@@ -2256,7 +2256,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If provided, the component is rendered as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -2266,7 +2266,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to download the linked URL.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -2276,7 +2276,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to open the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -2284,15 +2284,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -2304,11 +2304,11 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary one (i.e., when `target=\"_blank\"`).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
@@ -2336,7 +2336,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -2344,15 +2344,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -2360,7 +2360,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -2372,7 +2372,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Specifies that the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -2382,7 +2382,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Defines the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -2412,7 +2412,7 @@
         },
         {
           "name": "name",
-          "description": "The button's name, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button name submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -2422,7 +2422,7 @@
         },
         {
           "name": "value",
-          "description": "The button's value, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button value submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -2432,7 +2432,7 @@
         },
         {
           "name": "type",
-          "description": "Defines the button's default behavior. The default is `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Resets all the controls to their initial values.\n* `button`: No default behavior, does nothing when pressed by default.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "Specifies the button's default action. Default: `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Restores all controls to their initial values.\n* `button`: Does nothing by default.\n\n**Note**: Only available when `href` is not specified.",
           "values": [
             {
               "name": "submit",
@@ -2440,11 +2440,11 @@
             },
             {
               "name": "reset",
-              "description": "Resets all the controls to their initial values."
+              "description": "Resets all controls to their initial values."
             },
             {
               "name": "button",
-              "description": "No default behavior, does nothing when pressed by default."
+              "description": "Has no default action."
             }
           ],
           "references": [
@@ -2456,7 +2456,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the button with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the button is associated with its parent `<form>`, if any.\n\nThis attribute allows button elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.\n\n**Note**: Only available when `href` is not specified.",
+          "description": "Associates the button with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the button uses its parent `<form>`, if any.\n\nThis lets the button target any form in the document, not just the one it is nested in.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -2476,7 +2476,7 @@
         },
         {
           "name": "formenctype",
-          "description": "Specifies the form data encoding method. Possible values:\n\n* `application/x-www-form-urlencoded`: Default if the attribute is not used.\n* `multipart/form-data`: Used for `<input>` elements with `type` set to `file`.\n* `text/plain`: For debugging, not for real form submission.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies how to encode the form data. Possible values:\n\n* `application/x-www-form-urlencoded`: Default when the attribute is omitted.\n* `multipart/form-data`: Used for `<input>` elements with `type=\"file\"`.\n* `text/plain`: Useful for debugging, but not for actual form submissions.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "application/x-www-form-urlencoded",
@@ -2484,7 +2484,7 @@
             },
             {
               "name": "multipart/form-data",
-              "description": "Used for `<input>` elements with `type` set to `file`."
+              "description": "Used for `<input>` elements with `type=\"file\"`."
             },
             {
               "name": "text/plain",
@@ -2500,15 +2500,15 @@
         },
         {
           "name": "formmethod",
-          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Form data included in HTTP request body.\n* `get`: Form data appended to `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Sends the form data in the request body.\n* `get`: Appends the form data to the `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "post",
-              "description": "Form data included in HTTP request body."
+              "description": "Form data is included in the HTTP request body."
             },
             {
               "name": "get",
-              "description": "Form data appended to `action` URL."
+              "description": "Form data is appended to the `action` URL."
             }
           ],
           "references": [
@@ -2530,11 +2530,11 @@
         },
         {
           "name": "formtarget",
-          "description": "Specifies where to display the form submission response. Possible values:\n\n* `_self`: Current browsing context. (Default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context or `_self` if no parent.\n* `_top`: Topmost browsing context or `_self` if no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies where to open the response after form submission. Possible values:\n\n* `_self`: Current browsing context (default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context, or `_self` if there is no parent.\n* `_top`: Topmost browsing context, or `_self` if there are no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "_self",
-              "description": "Current browsing context. (Default)."
+              "description": "Current browsing context (default)."
             },
             {
               "name": "_blank",
@@ -2542,11 +2542,11 @@
             },
             {
               "name": "_parent",
-              "description": "Parent browsing context or `_self` if no parent."
+              "description": "Parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_top",
-              "description": "Topmost browsing context or `_self` if no ancestors."
+              "description": "Topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -2610,23 +2610,23 @@
       "attributes": [
         {
           "name": "placement",
-          "description": "Determines the component's position. Possible values:\n\n* `top`: Positions the component at the top.\n* `bottom`: Positions the component at the bottom.\n* `left`: Positions the component on the left.\n* `right`: Positions the component on the right.",
+          "description": "Determines where the component is placed. Possible values:\n\n* `top`: Places the component at the top.\n* `bottom`: Places the component at the bottom.\n* `left`: Places the component on the left.\n* `right`: Places the component on the right.",
           "values": [
             {
               "name": "top",
-              "description": "Positions the component at the top."
+              "description": "Places the component at the top."
             },
             {
               "name": "bottom",
-              "description": "Positions the component at the bottom."
+              "description": "Places the component at the bottom."
             },
             {
               "name": "left",
-              "description": "Positions the component on the left."
+              "description": "Places the component on the left."
             },
             {
               "name": "right",
-              "description": "Positions the component on the right."
+              "description": "Places the component on the right."
             }
           ],
           "references": [
@@ -2638,7 +2638,7 @@
         },
         {
           "name": "order",
-          "description": "Specifies the layout order within the [`<mdui-layout>`](https://www.mdui.org/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
+          "description": "Specifies the layout order within the [`<mdui-layout>`](/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
           "references": [
             {
               "name": "Docs",
@@ -2737,7 +2737,7 @@
     },
     {
       "name": "mdui-list-item",
-      "description": "List Item Component  It should be used in conjunction with the `<mdui-list>` component \n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
+      "description": "List Item Component  Use with the `<mdui-list>` component \n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
       "attributes": [
         {
           "name": "headline",
@@ -2751,19 +2751,19 @@
         },
         {
           "name": "headline-line",
-          "description": "Line limit for main text. Truncates after exceeding. Default is no limit. Possible values:\n\n* `1`: Single-line text, truncates after exceeding\n* `2`: Double-line text, truncates after exceeding.\n* `3`: Triple-line text, truncates after exceeding.",
+          "description": "Maximum number of lines for the main text. Overflow text is truncated. Default is no limit. Possible values:\n\n* `1`: Single-line text that truncates when it overflows.\n* `2`: Two-line text that truncates when it overflows.\n* `3`: Three-line text that truncates when it overflows.",
           "values": [
             {
               "name": "1",
-              "description": "Single-line text, truncates after exceeding."
+              "description": "Single-line text that truncates when it overflows."
             },
             {
               "name": "2",
-              "description": "Double-line text, truncates after exceeding."
+              "description": "Two-line text that truncates when it overflows."
             },
             {
               "name": "3",
-              "description": "Triple-line text, truncates after exceeding."
+              "description": "Three-line text that truncates when it overflows."
             }
           ],
           "references": [
@@ -2785,19 +2785,19 @@
         },
         {
           "name": "description-line",
-          "description": "Line limit for subtext. Truncates after exceeding. Default is no limit. Possible values:\n\n* `1`: Single-line text, truncates after exceeding\n* `2`: Double-line text, truncates after exceeding.\n* `3`: Triple-line text, truncates after exceeding.",
+          "description": "Maximum number of lines for the subtext. Overflow text is truncated. Default is no limit. Possible values:\n\n* `1`: Single-line text that truncates when it overflows.\n* `2`: Two-line text that truncates when it overflows.\n* `3`: Three-line text that truncates when it overflows.",
           "values": [
             {
               "name": "1",
-              "description": "Single-line text, truncates after exceeding."
+              "description": "Single-line text that truncates when it overflows."
             },
             {
               "name": "2",
-              "description": "Double-line text, truncates after exceeding."
+              "description": "Two-line text that truncates when it overflows."
             },
             {
               "name": "3",
-              "description": "Triple-line text, truncates after exceeding."
+              "description": "Three-line text that truncates when it overflows."
             }
           ],
           "references": [
@@ -2829,7 +2829,7 @@
         },
         {
           "name": "disabled",
-          "description": "Disables the list item. Grays out the item and disables elements like [`<mdui-checkbox>`](https://www.mdui.org/en/docs/2/components/checkbox), [`<mdui-radio>`](https://www.mdui.org/en/docs/2/components/radio), [`<mdui-switch>`](https://www.mdui.org/en/docs/2/components/switch).",
+          "description": "Disables the list item. It dims the item and disables interactive elements like [`<mdui-checkbox>`](/en/docs/2/components/checkbox), [`<mdui-radio>`](/en/docs/2/components/radio), and [`<mdui-switch>`](/en/docs/2/components/switch).",
           "references": [
             {
               "name": "Docs",
@@ -2839,7 +2839,7 @@
         },
         {
           "name": "active",
-          "description": "Activates the list item.",
+          "description": "Marks the list item as active.",
           "references": [
             {
               "name": "Docs",
@@ -2849,7 +2849,7 @@
         },
         {
           "name": "nonclickable",
-          "description": "Makes the list item non-clickable. Elements like [`<mdui-checkbox>`](https://www.mdui.org/en/docs/2/components/checkbox), [`<mdui-radio>`](https://www.mdui.org/en/docs/2/components/radio), [`<mdui-switch>`](https://www.mdui.org/en/docs/2/components/switch) remain interactive.",
+          "description": "Disables the list item's default click action, but interactive elements like [`<mdui-checkbox>`](/en/docs/2/components/checkbox), [`<mdui-radio>`](/en/docs/2/components/radio), and [`<mdui-switch>`](/en/docs/2/components/switch) inside it remain functional.",
           "references": [
             {
               "name": "Docs",
@@ -2859,7 +2859,7 @@
         },
         {
           "name": "rounded",
-          "description": "Applies rounded style to the list item.",
+          "description": "Applies a rounded appearance to the list item.",
           "references": [
             {
               "name": "Docs",
@@ -2869,7 +2869,7 @@
         },
         {
           "name": "alignment",
-          "description": "Vertical alignment of the list item. Possible values:\n\n* `start`: Top alignment.\n* `center`: Center alignment.\n* `end`: Bottom alignment.",
+          "description": "Vertical alignment of the list item. Possible values:\n\n* `start`: Aligns to the top.\n* `center`: Aligns to the center.\n* `end`: Aligns to the bottom.",
           "values": [
             {
               "name": "start",
@@ -2893,7 +2893,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If specified, the component renders as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -2903,7 +2903,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to treat the linked URL as a download.\n\n**Note**:  This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -2913,7 +2913,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to display the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent exists.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors exist.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -2921,15 +2921,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent exists."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors exist."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -2941,19 +2941,19 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: Author of the current document or article.\n* `bookmark`: Permanent link for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: Link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
-              "description": "Author of the current document or article."
+              "description": "The author of the current document or article."
             },
             {
               "name": "bookmark",
-              "description": "Permanent link for the nearest ancestor section."
+              "description": "The permalink for the nearest ancestor section."
             },
             {
               "name": "external",
@@ -2961,7 +2961,7 @@
             },
             {
               "name": "help",
-              "description": "Link to context-sensitive help."
+              "description": "A link to context-sensitive help."
             },
             {
               "name": "license",
@@ -2973,7 +2973,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -2981,15 +2981,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -2997,7 +2997,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -3009,7 +3009,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -3019,7 +3019,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -3041,7 +3041,7 @@
     },
     {
       "name": "mdui-list-subheader",
-      "description": "List Subheader Component  It should be used in conjunction with the `<mdui-list>` component \n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
+      "description": "List Subheader Component  Use with the `<mdui-list>` component \n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
       "attributes": [],
       "references": [
         {
@@ -3056,7 +3056,7 @@
     },
     {
       "name": "mdui-list",
-      "description": "List Component  It should be used in conjunction with the `<mdui-list-item>` component \n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
+      "description": "List Component  Use with the `<mdui-list-item>` component \n\n```html\n<mdui-list>\n  <mdui-list-subheader>Subheader</mdui-list-subheader>\n  <mdui-list-item>Item 1</mdui-list-item>\n  <mdui-list-item>Item 2</mdui-list-item>\n</mdui-list>\n```",
       "attributes": [],
       "references": [
         {
@@ -3145,7 +3145,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If specified, the component renders as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -3155,7 +3155,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to treat the linked URL as a download.\n\n**Note**:  This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -3165,7 +3165,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to display the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent exists.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors exist.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -3173,15 +3173,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent exists."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors exist."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -3193,19 +3193,19 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: Author of the current document or article.\n* `bookmark`: Permanent link for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: Link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
-              "description": "Author of the current document or article."
+              "description": "The author of the current document or article."
             },
             {
               "name": "bookmark",
-              "description": "Permanent link for the nearest ancestor section."
+              "description": "The permalink for the nearest ancestor section."
             },
             {
               "name": "external",
@@ -3213,7 +3213,7 @@
             },
             {
               "name": "help",
-              "description": "Link to context-sensitive help."
+              "description": "A link to context-sensitive help."
             },
             {
               "name": "license",
@@ -3225,7 +3225,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -3233,15 +3233,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -3249,7 +3249,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -3261,7 +3261,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -3271,7 +3271,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -3293,11 +3293,11 @@
     },
     {
       "name": "mdui-menu",
-      "description": "Menu Component  It should be used in conjunction with the `<mdui-menu-item>` component \n\n```html\n<mdui-menu>\n  <mdui-menu-item>Item 1</mdui-menu-item>\n  <mdui-menu-item>Item 2</mdui-menu-item>\n</mdui-menu>\n```",
+      "description": "Menu Component  Use with the `<mdui-menu-item>` component \n\n```html\n<mdui-menu>\n  <mdui-menu-item>Item 1</mdui-menu-item>\n  <mdui-menu-item>Item 2</mdui-menu-item>\n</mdui-menu>\n```",
       "attributes": [
         {
           "name": "selects",
-          "description": "Defines the selectable state of menu items. Defaults to non-selectable. Possible values:\n\n* `single`: Only one item can be selected at a time.\n* `multiple`: Multiple items can be selected.",
+          "description": "Controls whether menu items can be selected. They are not selectable by default. Possible values:\n\n* `single`: Only one item can be selected at a time.\n* `multiple`: Multiple items can be selected.",
           "values": [
             {
               "name": "single",
@@ -3317,7 +3317,7 @@
         },
         {
           "name": "value",
-          "description": "The value of the selected `<mdui-menu-item>`.\n\nNote: The HTML attribute is always a string and can only be set as an initial value when `selects=\"single\"`. The JavaScript property value is a string when `selects=\"single\"` and an array of strings when `selects=\"multiple\"`. In `selects=\"multiple\"`, this value can only be modified by changing the JavaScript property.",
+          "description": "The value of the selected `<mdui-menu-item>`.\n\n**Note**: The HTML attribute always accepts a string and can only be used as an initial value when `selects=\"single\"`. The JavaScript property is a string when `selects=\"single\"` and an array of strings when `selects=\"multiple\"`. When `selects=\"multiple\"`, update the JavaScript property to change this value.",
           "references": [
             {
               "name": "Docs",
@@ -3337,23 +3337,23 @@
         },
         {
           "name": "submenu-trigger",
-          "description": "Defines the trigger method for submenus. Supports multiple values separated by spaces. Possible values:\n\n* `click`: Open submenu when clicking on a menu item.\n* `hover`: Open submenu when hovering over a menu item.\n* `focus`: Open submenu when focusing on a menu item.\n* `manual`: Only programmatically open and close submenus, no other trigger methods can be specified.",
+          "description": "Defines how submenus open. Multiple space-separated values are supported. Possible values:\n\n* `click`: Opens the submenu when the menu item is clicked.\n* `hover`: Opens the submenu when hovering over a menu item.\n* `focus`: Opens the submenu when the menu item receives focus.\n* `manual`: Submenus can only be opened and closed programmatically; no other trigger methods can be specified.",
           "values": [
             {
               "name": "click",
-              "description": "Open submenu when clicking on a menu item."
+              "description": "Opens the submenu when the menu item is clicked."
             },
             {
               "name": "hover",
-              "description": "Open submenu when hovering over a menu item."
+              "description": "Opens the submenu when hovering over a menu item."
             },
             {
               "name": "focus",
-              "description": "Open submenu when focusing on a menu item."
+              "description": "Opens the submenu when the menu item receives focus."
             },
             {
               "name": "manual",
-              "description": "Only programmatically open and close submenus, no other trigger methods can be specified."
+              "description": "Submenus can only be opened and closed programmatically; no other trigger methods can be specified."
             }
           ],
           "references": [
@@ -3365,7 +3365,7 @@
         },
         {
           "name": "submenu-open-delay",
-          "description": "Specifies the delay (in milliseconds) for opening a submenu via hover.",
+          "description": "The delay (in milliseconds) before a submenu opens on hover.",
           "references": [
             {
               "name": "Docs",
@@ -3375,7 +3375,7 @@
         },
         {
           "name": "submenu-close-delay",
-          "description": "Specifies the delay (in milliseconds) for closing a submenu via hover.",
+          "description": "The delay (in milliseconds) before a submenu closes on hover.",
           "references": [
             {
               "name": "Docs",
@@ -3397,7 +3397,7 @@
     },
     {
       "name": "mdui-navigation-bar-item",
-      "description": "Navigation Bar Item Component  It should be used in conjunction with the `<mdui-navigation-bar>` component \n\n```html\n<mdui-navigation-bar>\n  <mdui-navigation-bar-item icon=\"place\">Item 1</mdui-navigation-bar-item>\n  <mdui-navigation-bar-item icon=\"commute\">Item 2</mdui-navigation-bar-item>\n  <mdui-navigation-bar-item icon=\"people\">Item 3</mdui-navigation-bar-item>\n</mdui-navigation-bar>\n```",
+      "description": "Navigation Bar Item Component  Use with the `<mdui-navigation-bar>` component \n\n```html\n<mdui-navigation-bar>\n  <mdui-navigation-bar-item icon=\"place\">Item 1</mdui-navigation-bar-item>\n  <mdui-navigation-bar-item icon=\"commute\">Item 2</mdui-navigation-bar-item>\n  <mdui-navigation-bar-item icon=\"people\">Item 3</mdui-navigation-bar-item>\n</mdui-navigation-bar>\n```",
       "attributes": [
         {
           "name": "icon",
@@ -3431,7 +3431,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If specified, the component renders as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -3441,7 +3441,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to treat the linked URL as a download.\n\n**Note**:  This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -3451,7 +3451,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to display the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent exists.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors exist.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -3459,15 +3459,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent exists."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors exist."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -3479,19 +3479,19 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: Author of the current document or article.\n* `bookmark`: Permanent link for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: Link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
-              "description": "Author of the current document or article."
+              "description": "The author of the current document or article."
             },
             {
               "name": "bookmark",
-              "description": "Permanent link for the nearest ancestor section."
+              "description": "The permalink for the nearest ancestor section."
             },
             {
               "name": "external",
@@ -3499,7 +3499,7 @@
             },
             {
               "name": "help",
-              "description": "Link to context-sensitive help."
+              "description": "A link to context-sensitive help."
             },
             {
               "name": "license",
@@ -3511,7 +3511,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -3519,15 +3519,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -3535,7 +3535,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -3547,7 +3547,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -3557,7 +3557,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -3579,11 +3579,11 @@
     },
     {
       "name": "mdui-navigation-bar",
-      "description": "Navigation Bar Component  It should be used in conjunction with the `<mdui-navigation-bar-item>` component \n\n```html\n<mdui-navigation-bar>\n  <mdui-navigation-bar-item icon=\"place\">Item 1</mdui-navigation-bar-item>\n  <mdui-navigation-bar-item icon=\"commute\">Item 2</mdui-navigation-bar-item>\n  <mdui-navigation-bar-item icon=\"people\">Item 3</mdui-navigation-bar-item>\n</mdui-navigation-bar>\n```",
+      "description": "Navigation Bar Component  Use with the `<mdui-navigation-bar-item>` component \n\n```html\n<mdui-navigation-bar>\n  <mdui-navigation-bar-item icon=\"place\">Item 1</mdui-navigation-bar-item>\n  <mdui-navigation-bar-item icon=\"commute\">Item 2</mdui-navigation-bar-item>\n  <mdui-navigation-bar-item icon=\"people\">Item 3</mdui-navigation-bar-item>\n</mdui-navigation-bar>\n```",
       "attributes": [
         {
           "name": "hide",
-          "description": "Hides the navigation bar when set.",
+          "description": "Whether the navigation bar is hidden.",
           "references": [
             {
               "name": "Docs",
@@ -3593,11 +3593,11 @@
         },
         {
           "name": "label-visibility",
-          "description": "Specifies the visibility of the text. Possible values:\n\n* `auto`: Visible if there are 3 or fewer options, otherwise only the selected state is visible.\n* `selected`: Only visible in the selected state.\n* `labeled`: Always visible.\n* `unlabeled`: Never visible.",
+          "description": "Specifies when the text is shown. Possible values:\n\n* `auto`: Visible if there are 3 or fewer items; otherwise, only visible in the selected state.\n* `selected`: Only visible in the selected state.\n* `labeled`: Always visible.\n* `unlabeled`: Never visible.",
           "values": [
             {
               "name": "auto",
-              "description": "Visible if there are 3 or fewer options, otherwise only the selected state is visible."
+              "description": "Visible if there are 3 or fewer items; otherwise, only visible in the selected state."
             },
             {
               "name": "selected",
@@ -3652,7 +3652,7 @@
         },
         {
           "name": "scroll-target",
-          "description": "The element that listens for scroll events. Accepts a CSS selector, DOM element, or [JQ object](https://www.mdui.org/en/docs/2/functions/jq). Defaults to `window`.",
+          "description": "The element to watch for scroll events. Accepts a CSS selector, a DOM element, or a [JQ object](/en/docs/2/functions/jq). Defaults to `window`.",
           "references": [
             {
               "name": "Docs",
@@ -3662,7 +3662,7 @@
         },
         {
           "name": "scroll-threshold",
-          "description": "The scroll distance (in pixels) that triggers the scroll behavior.",
+          "description": "The scroll distance (in pixels) required to trigger the scroll behavior.",
           "references": [
             {
               "name": "Docs",
@@ -3672,7 +3672,7 @@
         },
         {
           "name": "order",
-          "description": "Specifies the layout order within the [`<mdui-layout>`](https://www.mdui.org/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
+          "description": "Specifies the layout order within the [`<mdui-layout>`](/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
           "references": [
             {
               "name": "Docs",
@@ -3708,7 +3708,7 @@
         },
         {
           "name": "modal",
-          "description": "Displays an overlay when open.\n\nOn narrow devices (screen width < [`--mdui-breakpoint-md`](https://www.mdui.org/en/docs/2/styles/design-tokens#breakpoint)), the overlay always displays.",
+          "description": "Displays an overlay when open.\n\nOn narrow devices (screen width < [`--mdui-breakpoint-md`](/en/docs/2/styles/design-tokens#breakpoint)), the overlay is always displayed.",
           "references": [
             {
               "name": "Docs",
@@ -3738,7 +3738,7 @@
         },
         {
           "name": "placement",
-          "description": "Sets the drawer's display position. Possible values:\n\n* `left`: Display on the left side.\n* `right`: Display on the right side.",
+          "description": "Sets the drawer's position. Possible values:\n\n* `left`: Displays on the left side.\n* `right`: Displays on the right side.",
           "values": [
             {
               "name": "left",
@@ -3758,7 +3758,7 @@
         },
         {
           "name": "contained",
-          "description": "By default, the navigation drawer displays relative to the `body` element. When set, it displays relative to its parent element.\n\nNote: You must add `position: relative; overflow: hidden;` style to the parent element when this attribute is set.",
+          "description": "By default, the navigation drawer is positioned relative to the `body` element. If set, it is positioned relative to its parent element.\n\n**Note**: You must manually set `position: relative; overflow: hidden;` on the parent element when this attribute is set.",
           "references": [
             {
               "name": "Docs",
@@ -3768,7 +3768,7 @@
         },
         {
           "name": "order",
-          "description": "Specifies the layout order within the [`<mdui-layout>`](https://www.mdui.org/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
+          "description": "Specifies the layout order within the [`<mdui-layout>`](/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
           "references": [
             {
               "name": "Docs",
@@ -3790,7 +3790,7 @@
     },
     {
       "name": "mdui-navigation-rail-item",
-      "description": "Navigation Rail Item Component  It should be used in conjunction with the `<mdui-navigation-rail>` component \n\n```html\n<mdui-navigation-rail>\n  <mdui-navigation-rail-item icon=\"watch_later\">Recent</mdui-navigation-rail-item>\n  <mdui-navigation-rail-item icon=\"image\">Images</mdui-navigation-rail-item>\n  <mdui-navigation-rail-item icon=\"library_music\">Library</mdui-navigation-rail-item>\n</mdui-navigation-rail>\n```",
+      "description": "Navigation Rail Item Component  Use with the `<mdui-navigation-rail>` component \n\n```html\n<mdui-navigation-rail>\n  <mdui-navigation-rail-item icon=\"watch_later\">Recent</mdui-navigation-rail-item>\n  <mdui-navigation-rail-item icon=\"image\">Images</mdui-navigation-rail-item>\n  <mdui-navigation-rail-item icon=\"library_music\">Library</mdui-navigation-rail-item>\n</mdui-navigation-rail>\n```",
       "attributes": [
         {
           "name": "icon",
@@ -3824,7 +3824,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If specified, the component renders as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -3834,7 +3834,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to treat the linked URL as a download.\n\n**Note**:  This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -3844,7 +3844,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to display the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent exists.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors exist.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -3852,15 +3852,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent exists."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors exist."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -3872,19 +3872,19 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: Author of the current document or article.\n* `bookmark`: Permanent link for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: Link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
-              "description": "Author of the current document or article."
+              "description": "The author of the current document or article."
             },
             {
               "name": "bookmark",
-              "description": "Permanent link for the nearest ancestor section."
+              "description": "The permalink for the nearest ancestor section."
             },
             {
               "name": "external",
@@ -3892,7 +3892,7 @@
             },
             {
               "name": "help",
-              "description": "Link to context-sensitive help."
+              "description": "A link to context-sensitive help."
             },
             {
               "name": "license",
@@ -3904,7 +3904,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -3912,15 +3912,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -3928,7 +3928,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -3940,7 +3940,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -3950,7 +3950,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -3972,7 +3972,7 @@
     },
     {
       "name": "mdui-navigation-rail",
-      "description": "Navigation Rail Component  It should be used in conjunction with the `<mdui-navigation-rail-item>` component \n\n```html\n<mdui-navigation-rail>\n  <mdui-navigation-rail-item icon=\"watch_later\">Recent</mdui-navigation-rail-item>\n  <mdui-navigation-rail-item icon=\"image\">Images</mdui-navigation-rail-item>\n  <mdui-navigation-rail-item icon=\"library_music\">Library</mdui-navigation-rail-item>\n</mdui-navigation-rail>\n```",
+      "description": "Navigation Rail Component  Use with the `<mdui-navigation-rail-item>` component \n\n```html\n<mdui-navigation-rail>\n  <mdui-navigation-rail-item icon=\"watch_later\">Recent</mdui-navigation-rail-item>\n  <mdui-navigation-rail-item icon=\"image\">Images</mdui-navigation-rail-item>\n  <mdui-navigation-rail-item icon=\"library_music\">Library</mdui-navigation-rail-item>\n</mdui-navigation-rail>\n```",
       "attributes": [
         {
           "name": "value",
@@ -3986,7 +3986,7 @@
         },
         {
           "name": "placement",
-          "description": "Sets the navigation bar's position. Possible values:\n\n* `left`: Display on the left.\n* `right`: Display on the right.",
+          "description": "Sets the navigation rail's position. Possible values:\n\n* `left`: Displays on the left.\n* `right`: Displays on the right.",
           "values": [
             {
               "name": "left",
@@ -4006,7 +4006,7 @@
         },
         {
           "name": "alignment",
-          "description": "Sets the alignment of `<mdui-navigation-rail-item>`. Possible values:\n\n* `start`: Aligns to the top.\n* `center`: Aligns to the center.\n* `end`: Aligns to the bottom.",
+          "description": "Sets the alignment of `<mdui-navigation-rail-item>` elements. Possible values:\n\n* `start`: Aligns to the top.\n* `center`: Aligns to the center.\n* `end`: Aligns to the bottom.",
           "values": [
             {
               "name": "start",
@@ -4030,7 +4030,7 @@
         },
         {
           "name": "contained",
-          "description": "By default, the navigation rail displays relative to the `body` element. When set, it displays relative to its parent element.\n\nNote: You must add `position: relative; overflow: hidden;` style to the parent element when this attribute is set.",
+          "description": "By default, the navigation rail is positioned relative to the `body` element. If set, it is positioned relative to its parent element.\n\n**Note**: You must manually set `position: relative;` on the parent element when this attribute is set.",
           "references": [
             {
               "name": "Docs",
@@ -4040,7 +4040,7 @@
         },
         {
           "name": "divider",
-          "description": "Adds a divider between the navigation bar and the page content.",
+          "description": "Adds a divider between the navigation rail and the page content.",
           "references": [
             {
               "name": "Docs",
@@ -4050,7 +4050,7 @@
         },
         {
           "name": "order",
-          "description": "Specifies the layout order within the [`<mdui-layout>`](https://www.mdui.org/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
+          "description": "Specifies the layout order within the [`<mdui-layout>`](/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
           "references": [
             {
               "name": "Docs",
@@ -4072,11 +4072,11 @@
     },
     {
       "name": "mdui-radio-group",
-      "description": "Radio Group Component  It should be used in conjunction with the `<mdui-radio>` component \n\n```html\n<mdui-radio-group value=\"chinese\">\n  <mdui-radio value=\"chinese\">Chinese</mdui-radio>\n  <mdui-radio value=\"english\">English</mdui-radio>\n</mdui-radio-group>\n```",
+      "description": "Radio Group Component  Use with the `<mdui-radio>` component \n\n```html\n<mdui-radio-group value=\"chinese\">\n  <mdui-radio value=\"chinese\">Chinese</mdui-radio>\n  <mdui-radio value=\"english\">English</mdui-radio>\n</mdui-radio-group>\n```",
       "attributes": [
         {
           "name": "disabled",
-          "description": "Disables the radio group when set.",
+          "description": "Disables the radio group.",
           "references": [
             {
               "name": "Docs",
@@ -4086,7 +4086,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the radio group with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the radio group is associated with its parent `<form>`, if any.\n\nThis attribute allows radio group elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.",
+          "description": "Associates the radio group with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the radio group uses its parent `<form>`, if any.\n\nThis lets the radio group work with any form in the document, not just the one it is nested in.",
           "references": [
             {
               "name": "Docs",
@@ -4138,7 +4138,7 @@
     },
     {
       "name": "mdui-radio",
-      "description": "Radio Component  It should be used in conjunction with the `<mdui-radio-group>` component \n\n```html\n<mdui-radio-group value=\"chinese\">\n  <mdui-radio value=\"chinese\">Chinese</mdui-radio>\n  <mdui-radio value=\"english\">English</mdui-radio>\n</mdui-radio-group>\n```",
+      "description": "Radio Component  Use with the `<mdui-radio-group>` component \n\n```html\n<mdui-radio-group value=\"chinese\">\n  <mdui-radio value=\"chinese\">Chinese</mdui-radio>\n  <mdui-radio value=\"english\">English</mdui-radio>\n</mdui-radio-group>\n```",
       "attributes": [
         {
           "name": "value",
@@ -4152,7 +4152,7 @@
         },
         {
           "name": "disabled",
-          "description": "Disables the radio when set.",
+          "description": "Disables the radio.",
           "references": [
             {
               "name": "Docs",
@@ -4192,7 +4192,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -4202,7 +4202,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -4228,7 +4228,7 @@
       "attributes": [
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -4238,7 +4238,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -4288,7 +4288,7 @@
         },
         {
           "name": "nolabel",
-          "description": "Hides the tooltip.",
+          "description": "Hides the value label.",
           "references": [
             {
               "name": "Docs",
@@ -4308,7 +4308,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the slider with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the slider is associated with its parent `<form>`, if any.\n\nThis attribute allows slider elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.",
+          "description": "Associates the slider with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the slider uses its parent `<form>`, if any.\n\nThis lets the slider work with any form in the document, not just the one it is nested in.",
           "references": [
             {
               "name": "Docs",
@@ -4318,7 +4318,7 @@
         },
         {
           "name": "name",
-          "description": "Specifies the slider's name, which is submitted with the form data.",
+          "description": "Specifies the slider's name, which is submitted with form data.",
           "references": [
             {
               "name": "Docs",
@@ -4340,11 +4340,11 @@
     },
     {
       "name": "mdui-segmented-button-group",
-      "description": "Segmented Button Group Component  It should be used in conjunction with the `<mdui-segmented-button>` component \n\n```html\n<mdui-segmented-button-group>\n  <mdui-segmented-button>Day</mdui-segmented-button>\n  <mdui-segmented-button>Week</mdui-segmented-button>\n  <mdui-segmented-button>Month</mdui-segmented-button>\n</mdui-segmented-button-group>\n```",
+      "description": "Segmented Button Group Component  Use with the `<mdui-segmented-button>` component \n\n```html\n<mdui-segmented-button-group>\n  <mdui-segmented-button>Day</mdui-segmented-button>\n  <mdui-segmented-button>Week</mdui-segmented-button>\n  <mdui-segmented-button>Month</mdui-segmented-button>\n</mdui-segmented-button-group>\n```",
       "attributes": [
         {
           "name": "full-width",
-          "description": "If set, the segmented button group will fill the width of its parent element.",
+          "description": "If set, the segmented button group expands to fill the width of its container.",
           "references": [
             {
               "name": "Docs",
@@ -4354,7 +4354,7 @@
         },
         {
           "name": "selects",
-          "description": "Defines selectable states. Default is non-selectable. Possible values:\n\n* `single`: Only one can be selected.\n* `multiple`: Multiple selections are allowed.",
+          "description": "Controls whether the segmented button group can be selected. By default, it is not selectable. Possible values:\n\n* `single`: Only one can be selected.\n* `multiple`: Multiple selections are allowed.",
           "values": [
             {
               "name": "single",
@@ -4374,7 +4374,7 @@
         },
         {
           "name": "disabled",
-          "description": "Disables the segmented button group when set.",
+          "description": "Disables the segmented button group.",
           "references": [
             {
               "name": "Docs",
@@ -4394,7 +4394,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the segmented button group with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the segmented button group is associated with its parent `<form>`, if any.\n\nThis attribute allows segmented button group elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.",
+          "description": "Associates the segmented button group with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the segmented button group uses its parent `<form>`, if any.\n\nThis lets the segmented button group work with any form in the document, not just the one it is nested in.",
           "references": [
             {
               "name": "Docs",
@@ -4414,7 +4414,7 @@
         },
         {
           "name": "value",
-          "description": "The value of the selected `<mdui-segmented-button>`. This value is submitted with form data.\n\nNote: The HTML attribute is always a string and can only be set as an initial value when `selects=\"single\"`. The JavaScript property is a string when `selects=\"single\"` and an array of strings when `selects=\"multiple\"`. In `selects=\"multiple\"`, this value can only be modified by changing the JavaScript property.",
+          "description": "The value of the selected `<mdui-segmented-button>`. This value is submitted with form data.\n\n**Note**: The HTML attribute always accepts a string and can only be used as an initial value when `selects=\"single\"`. The JavaScript property is a string when `selects=\"single\"` and an array of strings when `selects=\"multiple\"`. When `selects=\"multiple\"`, update the JavaScript property to change this value.",
           "references": [
             {
               "name": "Docs",
@@ -4436,7 +4436,7 @@
     },
     {
       "name": "mdui-segmented-button",
-      "description": "Segmented Button Component  It should be used in conjunction with the `<mdui-segmented-button-group>` component \n\n```html\n<mdui-segmented-button-group>\n  <mdui-segmented-button>Day</mdui-segmented-button>\n  <mdui-segmented-button>Week</mdui-segmented-button>\n  <mdui-segmented-button>Month</mdui-segmented-button>\n</mdui-segmented-button-group>\n```",
+      "description": "Segmented Button Component  Use with the `<mdui-segmented-button-group>` component \n\n```html\n<mdui-segmented-button-group>\n  <mdui-segmented-button>Day</mdui-segmented-button>\n  <mdui-segmented-button>Week</mdui-segmented-button>\n  <mdui-segmented-button>Month</mdui-segmented-button>\n</mdui-segmented-button-group>\n```",
       "attributes": [
         {
           "name": "icon",
@@ -4470,7 +4470,7 @@
         },
         {
           "name": "href",
-          "description": "The URL for the hyperlink. If provided, the component is rendered as an `<a>` element and can use link-related attributes.",
+          "description": "The URL for the link. When set, the component renders as an `<a>` element and supports link-related attributes.",
           "references": [
             {
               "name": "Docs",
@@ -4480,7 +4480,7 @@
         },
         {
           "name": "download",
-          "description": "Instructs the browser to download the linked URL.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Downloads the linked URL.\n\n**Note**: Only available when `href` is specified.",
           "references": [
             {
               "name": "Docs",
@@ -4490,7 +4490,7 @@
         },
         {
           "name": "target",
-          "description": "Defines where to open the linked URL. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context or `_self` if no parent.\n* `_self`: Opens in the current browsing context. (Default).\n* `_top`: Opens in the topmost browsing context or `_self` if no ancestors.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Controls where the linked URL opens. Possible values:\n\n* `_blank`: Opens in a new tab or window.\n* `_parent`: Opens in the parent browsing context, or `_self` if there is no parent.\n* `_self`: Opens in the current browsing context (default).\n* `_top`: Opens in the topmost browsing context, or `_self` if there are no ancestors.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "_blank",
@@ -4498,15 +4498,15 @@
             },
             {
               "name": "_parent",
-              "description": "Opens in the parent browsing context or `_self` if no parent."
+              "description": "Opens in the parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_self",
-              "description": "Opens in the current browsing context. (Default)."
+              "description": "Opens in the current browsing context (default)."
             },
             {
               "name": "_top",
-              "description": "Opens in the topmost browsing context or `_self` if no ancestors."
+              "description": "Opens in the topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -4518,11 +4518,11 @@
         },
         {
           "name": "rel",
-          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: Alternate versions of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Indicates that the main content of the current document is covered by the copyright license described by the referenced document.\n* `me`: Indicates that the current document represents the person who owns the linked content.\n* `next`: Indicates that the current document is part of a series and the next document in the series is the referenced document.\n* `nofollow`: Indicates that the current document's original author or publisher does not endorse the referenced document.\n* `noreferrer`: No `Referer` header will be included. Also has the same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value).\n* `prev`: Indicates that the current document is part of a series and the previous document in the series is the referenced document.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Gives a tag (identified by the given address) that applies to the current document.\n\n**Note**: This is only available when `href` is specified.",
+          "description": "Specifies the relationship of the linked URL as space-separated link types. Possible values:\n\n* `alternate`: An alternate version of the current document.\n* `author`: The author of the current document or article.\n* `bookmark`: The permalink for the nearest ancestor section.\n* `external`: The referenced document is not part of the same site as the current document.\n* `help`: A link to context-sensitive help.\n* `license`: Content covered by the copyright license described by the referenced document.\n* `me`: Links to content owned by the current document's author.\n* `next`: The next document in the series.\n* `nofollow`: Not endorsed by the original author or publisher.\n* `noreferrer`: Prevents the `Referer` header from being sent. Same effect as `noopener`.\n* `opener`: Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary one (i.e., when `target=\"_blank\"`).\n* `prev`: The previous document in the series.\n* `search`: Links to a resource that can be used to search through the current document and its related pages.\n* `tag`: Marks the current document with the given tag.\n\n**Note**: Only available when `href` is specified.",
           "values": [
             {
               "name": "alternate",
-              "description": "Alternate versions of the current document."
+              "description": "An alternate version of the current document."
             },
             {
               "name": "author",
@@ -4550,7 +4550,7 @@
             },
             {
               "name": "next",
-              "description": "Indicates that the current document is part of a series and the next document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the next document in the series is the referenced document."
             },
             {
               "name": "nofollow",
@@ -4558,15 +4558,15 @@
             },
             {
               "name": "noreferrer",
-              "description": "No `Referer` header will be included. Also has the same effect as `noopener`."
+              "description": "Prevents the `Referer` header from being sent. It has the same effect as `noopener`."
             },
             {
               "name": "opener",
-              "description": "Creates an auxiliary browsing context if the hyperlink would otherwise create a top-level browsing context that is not an auxiliary browsing context (i.e., has \"`_blank`\" as `target` attribute value)."
+              "description": "Creates a new browsing context when the hyperlink would otherwise open in a top-level context that is not auxiliary (for example, when `target=\"_blank\"` is specified)."
             },
             {
               "name": "prev",
-              "description": "Indicates that the current document is part of a series and the previous document in the series is the referenced document."
+              "description": "Indicates that the current document is part of a series and that the previous document in the series is the referenced document."
             },
             {
               "name": "search",
@@ -4574,7 +4574,7 @@
             },
             {
               "name": "tag",
-              "description": "Gives a tag (identified by the given address) that applies to the current document."
+              "description": "Assigns a tag, identified by the given address, to the current document."
             }
           ],
           "references": [
@@ -4586,7 +4586,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Specifies that the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -4596,7 +4596,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Defines the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -4626,7 +4626,7 @@
         },
         {
           "name": "name",
-          "description": "The button's name, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button name submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -4636,7 +4636,7 @@
         },
         {
           "name": "value",
-          "description": "The button's value, which is submitted with form data.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "The button value submitted with form data.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -4646,7 +4646,7 @@
         },
         {
           "name": "type",
-          "description": "Defines the button's default behavior. The default is `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Resets all the controls to their initial values.\n* `button`: No default behavior, does nothing when pressed by default.\n\n**Note**: This is only available when `href` is not specified.",
+          "description": "Specifies the button's default action. Default: `button`. Possible values:\n\n* `submit`: Submits the form data to the server.\n* `reset`: Restores all controls to their initial values.\n* `button`: Does nothing by default.\n\n**Note**: Only available when `href` is not specified.",
           "values": [
             {
               "name": "submit",
@@ -4654,11 +4654,11 @@
             },
             {
               "name": "reset",
-              "description": "Resets all the controls to their initial values."
+              "description": "Resets all controls to their initial values."
             },
             {
               "name": "button",
-              "description": "No default behavior, does nothing when pressed by default."
+              "description": "Has no default action."
             }
           ],
           "references": [
@@ -4670,7 +4670,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the button with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the button is associated with its parent `<form>`, if any.\n\nThis attribute allows button elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.\n\n**Note**: Only available when `href` is not specified.",
+          "description": "Associates the button with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the button uses its parent `<form>`, if any.\n\nThis lets the button target any form in the document, not just the one it is nested in.\n\n**Note**: Only available when `href` is not specified.",
           "references": [
             {
               "name": "Docs",
@@ -4690,7 +4690,7 @@
         },
         {
           "name": "formenctype",
-          "description": "Specifies the form data encoding method. Possible values:\n\n* `application/x-www-form-urlencoded`: Default if the attribute is not used.\n* `multipart/form-data`: Used for `<input>` elements with `type` set to `file`.\n* `text/plain`: For debugging, not for real form submission.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies how to encode the form data. Possible values:\n\n* `application/x-www-form-urlencoded`: Default when the attribute is omitted.\n* `multipart/form-data`: Used for `<input>` elements with `type=\"file\"`.\n* `text/plain`: Useful for debugging, but not for actual form submissions.\n\nOverrides the `enctype` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "application/x-www-form-urlencoded",
@@ -4698,7 +4698,7 @@
             },
             {
               "name": "multipart/form-data",
-              "description": "Used for `<input>` elements with `type` set to `file`."
+              "description": "Used for `<input>` elements with `type=\"file\"`."
             },
             {
               "name": "text/plain",
@@ -4714,15 +4714,15 @@
         },
         {
           "name": "formmethod",
-          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Form data included in HTTP request body.\n* `get`: Form data appended to `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies the HTTP method for form submission. Possible values:\n\n* `post`: Sends the form data in the request body.\n* `get`: Appends the form data to the `action` URL.\n\nOverrides the `method` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "post",
-              "description": "Form data included in HTTP request body."
+              "description": "Form data is included in the HTTP request body."
             },
             {
               "name": "get",
-              "description": "Form data appended to `action` URL."
+              "description": "Form data is appended to the `action` URL."
             }
           ],
           "references": [
@@ -4744,11 +4744,11 @@
         },
         {
           "name": "formtarget",
-          "description": "Specifies where to display the form submission response. Possible values:\n\n* `_self`: Current browsing context. (Default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context or `_self` if no parent.\n* `_top`: Topmost browsing context or `_self` if no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
+          "description": "Specifies where to open the response after form submission. Possible values:\n\n* `_self`: Current browsing context (default).\n* `_blank`: New tab or window.\n* `_parent`: Parent browsing context, or `_self` if there is no parent.\n* `_top`: Topmost browsing context, or `_self` if there are no ancestors.\n\nOverrides the `target` attribute of the button's form owner.\n\n**Note**: Only available when `href` is not specified and `type=\"submit\"`.",
           "values": [
             {
               "name": "_self",
-              "description": "Current browsing context. (Default)."
+              "description": "Current browsing context (default)."
             },
             {
               "name": "_blank",
@@ -4756,11 +4756,11 @@
             },
             {
               "name": "_parent",
-              "description": "Parent browsing context or `_self` if no parent."
+              "description": "Parent browsing context, or `_self` if there is no parent."
             },
             {
               "name": "_top",
-              "description": "Topmost browsing context or `_self` if no ancestors."
+              "description": "Topmost browsing context, or `_self` if there are no ancestors."
             }
           ],
           "references": [
@@ -4784,19 +4784,19 @@
     },
     {
       "name": "mdui-select",
-      "description": "Select Component  It should be used in conjunction with the `<mdui-menu-item>` component \n\n```html\n<mdui-select>\n  <mdui-menu-item value=\"item-1\">Item 1</mdui-menu-item>\n  <mdui-menu-item value=\"item-2\">Item 2</mdui-menu-item>\n</mdui-select>\n```",
+      "description": "Select Component  Use with the `<mdui-menu-item>` component \n\n```html\n<mdui-select>\n  <mdui-menu-item value=\"item-1\">Item 1</mdui-menu-item>\n  <mdui-menu-item value=\"item-2\">Item 2</mdui-menu-item>\n</mdui-select>\n```",
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the select style. Possible values:\n\n* `filled`: Solid background, strong visual emphasis.\n* `outlined`: Bordered, less visual emphasis.",
+          "description": "Defines the select variant. Possible values:\n\n* `filled`: Solid background with strong visual emphasis.\n* `outlined`: Bordered with lighter visual emphasis.",
           "values": [
             {
               "name": "filled",
-              "description": "Solid background, strong visual emphasis."
+              "description": "Solid background with strong visual emphasis."
             },
             {
               "name": "outlined",
-              "description": "Bordered, less visual emphasis."
+              "description": "Bordered with lighter visual emphasis."
             }
           ],
           "references": [
@@ -4828,7 +4828,7 @@
         },
         {
           "name": "value",
-          "description": "Value of the select, which is submitted with form data.\n\nIf `multiple` is not set, the value is a string; if set, it's an array of strings. HTML attributes can only set string values; array values must be set via JavaScript property.",
+          "description": "Value of the select, which is submitted with form data.\n\nIf `multiple` is not set, the value is a string; otherwise, it is an array of strings. HTML attributes can only set string values; array values must be set via the JavaScript property.",
           "references": [
             {
               "name": "Docs",
@@ -4868,7 +4868,7 @@
         },
         {
           "name": "clearable",
-          "description": "Allows the select to be cleared.",
+          "description": "Makes the select clearable.",
           "references": [
             {
               "name": "Docs",
@@ -4878,7 +4878,7 @@
         },
         {
           "name": "clear-icon",
-          "description": "Material Icons name for the clear button displayed on the right of the select when clearable. Alternatively, use `slot=\"clear-icon\"`.",
+          "description": "Material Icons name for the clear button displayed on the right when clearable. Alternatively, use `slot=\"clear-icon\"`.",
           "references": [
             {
               "name": "Docs",
@@ -4972,7 +4972,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the select with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the select is associated with its parent `<form>`, if any.\n\nThis attribute allows select elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.",
+          "description": "Associates the select with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the select uses its parent `<form>`, if any.\n\nThis lets the select work with any form in the document, not just the one it is nested in.",
           "references": [
             {
               "name": "Docs",
@@ -5012,7 +5012,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -5022,7 +5022,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -5058,7 +5058,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -5068,7 +5068,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -5118,7 +5118,7 @@
         },
         {
           "name": "nolabel",
-          "description": "Hides the tooltip.",
+          "description": "Hides the value label.",
           "references": [
             {
               "name": "Docs",
@@ -5138,7 +5138,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the slider with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the slider is associated with its parent `<form>`, if any.\n\nThis attribute allows slider elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.",
+          "description": "Associates the slider with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the slider uses its parent `<form>`, if any.\n\nThis lets the slider work with any form in the document, not just the one it is nested in.",
           "references": [
             {
               "name": "Docs",
@@ -5148,7 +5148,7 @@
         },
         {
           "name": "name",
-          "description": "Specifies the slider's name, which is submitted with the form data.",
+          "description": "Specifies the slider's name, which is submitted with form data.",
           "references": [
             {
               "name": "Docs",
@@ -5184,31 +5184,31 @@
         },
         {
           "name": "placement",
-          "description": "Snackbar placement. Default is `bottom`. Possible values:\n\n* `top`: Top, centered.\n* `top-start`: Top, left-aligned.\n* `top-end`: Top, right-aligned.\n* `bottom`: Bottom, centered.\n* `bottom-start`: Bottom, left-aligned.\n* `bottom-end`: Bottom, right-aligned.",
+          "description": "Snackbar placement. Default is `bottom`. Possible values:\n\n* `top`: Top center.\n* `top-start`: Top left.\n* `top-end`: Top right.\n* `bottom`: Bottom center.\n* `bottom-start`: Bottom left.\n* `bottom-end`: Bottom right.",
           "values": [
             {
               "name": "top",
-              "description": "Top, centered."
+              "description": "Top center."
             },
             {
               "name": "top-start",
-              "description": "Top, left-aligned."
+              "description": "Top left."
             },
             {
               "name": "top-end",
-              "description": "Top, right-aligned."
+              "description": "Top right."
             },
             {
               "name": "bottom",
-              "description": "Bottom, centered."
+              "description": "Bottom center."
             },
             {
               "name": "bottom-start",
-              "description": "Bottom, left-aligned."
+              "description": "Bottom left."
             },
             {
               "name": "bottom-end",
-              "description": "Bottom, right-aligned."
+              "description": "Bottom right."
             }
           ],
           "references": [
@@ -5230,7 +5230,7 @@
         },
         {
           "name": "action-loading",
-          "description": "Indicates if the action button is in the loading state.",
+          "description": "Whether the action button is in a loading state.",
           "references": [
             {
               "name": "Docs",
@@ -5280,7 +5280,7 @@
         },
         {
           "name": "auto-close-delay",
-          "description": "Automatically closes the Snackbar after a specified time (in milliseconds). Set to `0` to disable auto-closing. Default is 5 seconds.",
+          "description": "Automatically closes the Snackbar after the given delay (in milliseconds). Set to `0` to disable auto-close. Default is `5000`.",
           "references": [
             {
               "name": "Docs",
@@ -5290,7 +5290,7 @@
         },
         {
           "name": "close-on-outside-click",
-          "description": "Closes the Snackbar when clicking or touching outside the Snackbar area.",
+          "description": "Closes the Snackbar when the user clicks or touches outside it.",
           "references": [
             {
               "name": "Docs",
@@ -5346,7 +5346,7 @@
         },
         {
           "name": "checked-icon",
-          "description": "The Material Icons name for the checked state. Alternatively, use `slot=\"checked-icon\"`. Defaults to the `check` icon; an empty string removes the default icon.",
+          "description": "The Material Icons name for the checked state. Alternatively, use `slot=\"checked-icon\"`. Defaults to the `check` icon; setting an empty string removes the default icon.",
           "references": [
             {
               "name": "Docs",
@@ -5356,7 +5356,7 @@
         },
         {
           "name": "required",
-          "description": "The switch must be checked when submitting the form.",
+          "description": "The switch must be checked before the form is submitted.",
           "references": [
             {
               "name": "Docs",
@@ -5366,7 +5366,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the switch with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the switch is associated with its parent `<form>`, if any.\n\nThis attribute allows switch elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.",
+          "description": "Associates the switch with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the switch uses its parent `<form>`, if any.\n\nThis lets the switch work with any form in the document, not just the one it is nested in.",
           "references": [
             {
               "name": "Docs",
@@ -5396,7 +5396,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -5406,7 +5406,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -5428,7 +5428,7 @@
     },
     {
       "name": "mdui-tab-panel",
-      "description": "Tab Panel Component  It should be used in conjunction with the `<mdui-tabs>` and `<mdui-tab>` components \n\n```html\n<mdui-tabs value=\"tab-1\">\n  <mdui-tab value=\"tab-1\">Tab 1</mdui-tab>\n  <mdui-tab value=\"tab-2\">Tab 2</mdui-tab>\n  <mdui-tab value=\"tab-3\">Tab 3</mdui-tab>\n\n  <mdui-tab-panel slot=\"panel\" value=\"tab-1\">Panel 1</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-2\">Panel 2</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-3\">Panel 3</mdui-tab-panel>\n</mdui-tabs>\n```",
+      "description": "Tab Panel Component  Use with the `<mdui-tabs>` and `<mdui-tab>` components \n\n```html\n<mdui-tabs value=\"tab-1\">\n  <mdui-tab value=\"tab-1\">Tab 1</mdui-tab>\n  <mdui-tab value=\"tab-2\">Tab 2</mdui-tab>\n  <mdui-tab value=\"tab-3\">Tab 3</mdui-tab>\n\n  <mdui-tab-panel slot=\"panel\" value=\"tab-1\">Panel 1</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-2\">Panel 2</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-3\">Panel 3</mdui-tab-panel>\n</mdui-tabs>\n```",
       "attributes": [
         {
           "name": "value",
@@ -5454,7 +5454,7 @@
     },
     {
       "name": "mdui-tab",
-      "description": "Tab Component  It should be used in conjunction with the `<mdui-tabs>` and `<mdui-tab-panel>` components \n\n```html\n<mdui-tabs value=\"tab-1\">\n  <mdui-tab value=\"tab-1\">Tab 1</mdui-tab>\n  <mdui-tab value=\"tab-2\">Tab 2</mdui-tab>\n  <mdui-tab value=\"tab-3\">Tab 3</mdui-tab>\n\n  <mdui-tab-panel slot=\"panel\" value=\"tab-1\">Panel 1</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-2\">Panel 2</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-3\">Panel 3</mdui-tab-panel>\n</mdui-tabs>\n```",
+      "description": "Tab Component  Use with the `<mdui-tabs>` and `<mdui-tab-panel>` components \n\n```html\n<mdui-tabs value=\"tab-1\">\n  <mdui-tab value=\"tab-1\">Tab 1</mdui-tab>\n  <mdui-tab value=\"tab-2\">Tab 2</mdui-tab>\n  <mdui-tab value=\"tab-3\">Tab 3</mdui-tab>\n\n  <mdui-tab-panel slot=\"panel\" value=\"tab-1\">Panel 1</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-2\">Panel 2</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-3\">Panel 3</mdui-tab-panel>\n</mdui-tabs>\n```",
       "attributes": [
         {
           "name": "value",
@@ -5488,7 +5488,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -5498,7 +5498,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -5520,11 +5520,11 @@
     },
     {
       "name": "mdui-tabs",
-      "description": "Tabs Component  It should be used in conjunction with the `<mdui-tab>` and `<mdui-tab-panel>` components \n\n```html\n<mdui-tabs value=\"tab-1\">\n  <mdui-tab value=\"tab-1\">Tab 1</mdui-tab>\n  <mdui-tab value=\"tab-2\">Tab 2</mdui-tab>\n  <mdui-tab value=\"tab-3\">Tab 3</mdui-tab>\n\n  <mdui-tab-panel slot=\"panel\" value=\"tab-1\">Panel 1</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-2\">Panel 2</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-3\">Panel 3</mdui-tab-panel>\n</mdui-tabs>\n```",
+      "description": "Tabs Component  Use with the `<mdui-tab>` and `<mdui-tab-panel>` components \n\n```html\n<mdui-tabs value=\"tab-1\">\n  <mdui-tab value=\"tab-1\">Tab 1</mdui-tab>\n  <mdui-tab value=\"tab-2\">Tab 2</mdui-tab>\n  <mdui-tab value=\"tab-3\">Tab 3</mdui-tab>\n\n  <mdui-tab-panel slot=\"panel\" value=\"tab-1\">Panel 1</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-2\">Panel 2</mdui-tab-panel>\n  <mdui-tab-panel slot=\"panel\" value=\"tab-3\">Panel 3</mdui-tab-panel>\n</mdui-tabs>\n```",
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the tab shape. Possible values:\n\n* `primary`: Located below `<mdui-top-app-bar>`, used for switching between main application pages.\n* `secondary`: Located within the page, used for switching between related content groups.",
+          "description": "Defines the tab variant. Possible values:\n\n* `primary`: Sits below `<mdui-top-app-bar>` and is used to switch between main application pages.\n* `secondary`: Sits within the page and is used to switch between related content groups.",
           "values": [
             {
               "name": "primary",
@@ -5554,55 +5554,55 @@
         },
         {
           "name": "placement",
-          "description": "Defines the tab position. Default is `top-start`. Possible values:\n\n* `top-start`: Top, left-aligned.\n* `top`: Top, center-aligned.\n* `top-end`: Top, right-aligned.\n* `bottom-start`: Bottom, left-aligned.\n* `bottom`: Bottom, center-aligned.\n* `bottom-end`: Bottom, right-aligned.\n* `left-start`: Left, top-aligned.\n* `left`: Left, center-aligned.\n* `left-end`: Left, bottom-aligned.\n* `right-start`: Right, top-aligned.\n* `right`: Right, center-aligned.\n* `right-end`: Right, bottom-aligned.",
+          "description": "Defines the tab position. Default is `top-start`. Possible values:\n\n* `top-start`: Top left.\n* `top`: Top centered.\n* `top-end`: Top right.\n* `bottom-start`: Bottom left.\n* `bottom`: Bottom, centered.\n* `bottom-end`: Bottom right.\n* `left-start`: Left top.\n* `left`: Left, centered.\n* `left-end`: Left bottom.\n* `right-start`: Right top.\n* `right`: Right, centered.\n* `right-end`: Right bottom.",
           "values": [
             {
               "name": "top-start",
-              "description": "Top, left-aligned."
+              "description": "Top left."
             },
             {
               "name": "top",
-              "description": "Top, center-aligned."
+              "description": "Top centered."
             },
             {
               "name": "top-end",
-              "description": "Top, right-aligned."
+              "description": "Top right."
             },
             {
               "name": "bottom-start",
-              "description": "Bottom, left-aligned."
+              "description": "Bottom left."
             },
             {
               "name": "bottom",
-              "description": "Bottom, center-aligned."
+              "description": "Bottom, centered."
             },
             {
               "name": "bottom-end",
-              "description": "Bottom, right-aligned."
+              "description": "Bottom right."
             },
             {
               "name": "left-start",
-              "description": "Left, top-aligned."
+              "description": "Left top."
             },
             {
               "name": "left",
-              "description": "Left, center-aligned."
+              "description": "Left, centered."
             },
             {
               "name": "left-end",
-              "description": "Left, bottom-aligned."
+              "description": "Left bottom."
             },
             {
               "name": "right-start",
-              "description": "Right, top-aligned."
+              "description": "Right top."
             },
             {
               "name": "right",
-              "description": "Right, center-aligned."
+              "description": "Right, centered."
             },
             {
               "name": "right-end",
-              "description": "Right, bottom-aligned."
+              "description": "Right bottom."
             }
           ],
           "references": [
@@ -5614,7 +5614,7 @@
         },
         {
           "name": "full-width",
-          "description": "If set, the tabs will fill the width of its parent element.",
+          "description": "If set, the tabs will fill the width of their parent element.",
           "references": [
             {
               "name": "Docs",
@@ -5640,15 +5640,15 @@
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the text field style. Default is `filled`. Possible values:\n\n* `filled`: Text field with background color, providing a stronger visual effect.\n* `outlined`: Text field with border, providing a subtler visual effect.",
+          "description": "Defines the text field variant. Default is `filled`. Possible values:\n\n* `filled`: Text field with a background color for stronger visual emphasis.\n* `outlined`: Text field with a border for subtler visual emphasis.",
           "values": [
             {
               "name": "filled",
-              "description": "Text field with background color, providing a stronger visual effect."
+              "description": "Text field with a background color for stronger visual emphasis."
             },
             {
               "name": "outlined",
-              "description": "Text field with border, providing a subtler visual effect."
+              "description": "Text field with a border for subtler visual emphasis."
             }
           ],
           "references": [
@@ -5660,7 +5660,7 @@
         },
         {
           "name": "type",
-          "description": "Specifies the text field type. Default is `text`. Possible values:\n\n* `text`: Standard text field.\n* `number`: Allows only numeric input. Devices with dynamic keyboards will display a numeric keyboard.\n* `password`: Masks the input for password confidentiality.\n* `url`: Validates URL format. Devices with dynamic keyboards will display a URL-specific keyboard.\n* `email`: Validates email format. Devices with dynamic keyboards will display an email-specific keyboard.\n* `search`: Changes the enter icon to a search icon on devices with dynamic keyboards.\n* `tel`: Displays a phone number keyboard on devices with dynamic keyboards.\n* `hidden`: Hides the control, but its value will still be submitted to the server.\n* `date`: Activates a date picker or a numeric scroll wheel for year, month, and day in supported browsers.\n* `datetime-local`: Activates a date and time picker in supported browsers, excluding time zone.\n* `month`: Allows input for year and month, excluding time zone.\n* `time`: Allows time input, excluding time zone.\n* `week`: Allows input for dates consisting of a year and week, excluding time zone.",
+          "description": "Specifies the text field type. Default is `text`. Possible values:\n\n* `text`: Standard text field.\n* `number`: Allows numeric input only. Virtual keyboards on mobile devices show a numeric layout.\n* `password`: Hides the password as you type.\n* `url`: Validates URL format. Virtual keyboards on mobile devices show a URL-specific layout.\n* `email`: Validates email format. Virtual keyboards on mobile devices show an email-specific layout.\n* `search`: Shows a search icon on the Enter key in virtual keyboards.\n* `tel`: Displays a phone keypad on virtual keyboards.\n* `hidden`: Hides the control, but its value is still submitted to the server.\n* `date`: Opens a date picker or a numeric scroll wheel for year, month, and day in supported browsers.\n* `datetime-local`: Activates a date and time picker in supported browsers, without a time zone.\n* `month`: Allows entering a year and month without a time zone.\n* `time`: Allows time input without a time zone.\n* `week`: Allows entering a year and week without a time zone.",
           "values": [
             {
               "name": "text",
@@ -5668,35 +5668,35 @@
             },
             {
               "name": "number",
-              "description": "Allows only numeric input. Devices with dynamic keyboards will display a numeric keyboard."
+              "description": "Allows only numeric input. Devices with virtual keyboards will display a numeric keyboard."
             },
             {
               "name": "password",
-              "description": "Masks the input for password confidentiality."
+              "description": "Hides the password as you type."
             },
             {
               "name": "url",
-              "description": "Validates URL format. Devices with dynamic keyboards will display a URL-specific keyboard."
+              "description": "Validates URL format. Devices with virtual keyboards will display a URL-specific keyboard."
             },
             {
               "name": "email",
-              "description": "Validates email format. Devices with dynamic keyboards will display an email-specific keyboard."
+              "description": "Validates email format. Devices with virtual keyboards will display an email-specific keyboard."
             },
             {
               "name": "search",
-              "description": "Changes the enter icon to a search icon on devices with dynamic keyboards."
+              "description": "Shows a search icon on the Enter key in virtual keyboards."
             },
             {
               "name": "tel",
-              "description": "Displays a phone number keyboard on devices with dynamic keyboards."
+              "description": "Displays a phone keypad on virtual keyboards."
             },
             {
               "name": "hidden",
-              "description": "Hides the control, but its value will still be submitted to the server."
+              "description": "Hides the control, but its value is still submitted to the server."
             },
             {
               "name": "date",
-              "description": "Activates a date picker or a numeric scroll wheel for year, month, and day in supported browsers."
+              "description": "Opens a date picker or a numeric scroll wheel for year, month, and day in supported browsers."
             },
             {
               "name": "datetime-local",
@@ -5704,7 +5704,7 @@
             },
             {
               "name": "month",
-              "description": "Allows input for year and month, excluding time zone."
+              "description": "Allows entering a year and month, without a time zone."
             },
             {
               "name": "time",
@@ -5712,7 +5712,7 @@
             },
             {
               "name": "week",
-              "description": "Allows input for dates consisting of a year and week, excluding time zone."
+              "description": "Allows entering a year and week, without a time zone."
             }
           ],
           "references": [
@@ -5724,7 +5724,7 @@
         },
         {
           "name": "name",
-          "description": "The name of text field, which is submitted with form data.",
+          "description": "The name of the text field, which is submitted with form data.",
           "references": [
             {
               "name": "Docs",
@@ -5734,7 +5734,7 @@
         },
         {
           "name": "value",
-          "description": "The value of text field, which is submitted with form data.",
+          "description": "The value of the text field, which is submitted with form data.",
           "references": [
             {
               "name": "Docs",
@@ -5774,7 +5774,7 @@
         },
         {
           "name": "helper-on-focus",
-          "description": "If set, the helper text is only displayed when the text field is focused.",
+          "description": "Shows the helper text only when the text field is focused.",
           "references": [
             {
               "name": "Docs",
@@ -5784,7 +5784,7 @@
         },
         {
           "name": "clearable",
-          "description": "If set, the text field can be cleared.",
+          "description": "Makes the text field clearable.",
           "references": [
             {
               "name": "Docs",
@@ -5794,7 +5794,7 @@
         },
         {
           "name": "clear-icon",
-          "description": "Material Icons name displayed on the right when the text field is clearable. Alternatively, use `slot=\"clear-icon\"`.",
+          "description": "Material Icons name shown on the right when the text field is clearable. Alternatively, use `slot=\"clear-icon\"`.",
           "references": [
             {
               "name": "Docs",
@@ -5854,7 +5854,7 @@
         },
         {
           "name": "error-icon",
-          "description": "Material Icons name displayed on the right side of the text field when the form field validation fails. Alternatively, use `slot=\"error-icon\"`.",
+          "description": "Material Icons name displayed on the right side of the text field when form field validation fails. Alternatively, use `slot=\"error-icon\"`.",
           "references": [
             {
               "name": "Docs",
@@ -5864,7 +5864,7 @@
         },
         {
           "name": "form",
-          "description": "Associates the text field with a `<form>` element. The value should be the `id` of a `<form>` in the same document. If not set, the text field is associated with its parent `<form>`, if any.\n\nThis attribute allows text field elements to be associated with `<form>`s anywhere in the document, not just inside a `<form>`.",
+          "description": "Associates the text field with a `<form>` element. Set this to the `id` of a `<form>` in the same document. If omitted, the text field uses its parent `<form>`, if any.\n\nThis lets the text field work with any form in the document, not just the one it is nested in.",
           "references": [
             {
               "name": "Docs",
@@ -5894,7 +5894,7 @@
         },
         {
           "name": "required",
-          "description": "The field must be filled in before the form is submitted.",
+          "description": "The field must be filled out before the form is submitted.",
           "references": [
             {
               "name": "Docs",
@@ -5914,7 +5914,7 @@
         },
         {
           "name": "autosize",
-          "description": "Allows the text field height to adjust automatically based on the input content.",
+          "description": "Automatically adjusts the height of the text field based on its content.",
           "references": [
             {
               "name": "Docs",
@@ -5994,7 +5994,7 @@
         },
         {
           "name": "step",
-          "description": "The step interval during increment and decrement when `type` is `number`.",
+          "description": "The step interval for increment/decrement when `type` is `number`.",
           "references": [
             {
               "name": "Docs",
@@ -6014,7 +6014,7 @@
         },
         {
           "name": "toggle-password",
-          "description": "Adds a toggle button for showing and hiding the password when `type` is `password`.",
+          "description": "Adds a toggle button to show or hide the password when `type` is `password`.",
           "references": [
             {
               "name": "Docs",
@@ -6092,7 +6092,7 @@
         },
         {
           "name": "enterkeyhint",
-          "description": "Customizes the Enter key text or icon on the virtual keyboard. The effect varies based on the device and language. Possible values:\n\n* `enter`: Inserts a new line, typically used in a multi-line text field.\n* `done`: Indicates input completion, closes the virtual keyboard.\n* `go`: Navigates to the target of the entered text.\n* `next`: Moves to the next text field.\n* `previous`: Moves to the previous text field.\n* `search`: Navigates to search results.\n* `send`: Sends a text message.",
+          "description": "Customizes the Enter key text or icon on the virtual keyboard. The effect varies by device and language. Possible values:\n\n* `enter`: Inserts a new line, typically used in a multi-line text field.\n* `done`: Indicates completion and closes the virtual keyboard.\n* `go`: Navigates to the target of the entered text.\n* `next`: Moves to the next text field.\n* `previous`: Moves to the previous text field.\n* `search`: Navigates to search results.\n* `send`: Sends a text message.",
           "values": [
             {
               "name": "enter",
@@ -6132,7 +6132,7 @@
         },
         {
           "name": "spellcheck",
-          "description": "Enable spell checking.",
+          "description": "Enables spell checking.",
           "references": [
             {
               "name": "Docs",
@@ -6142,7 +6142,7 @@
         },
         {
           "name": "inputmode",
-          "description": "Customizes the virtual keyboard. Possible values:\n\n* `none`: No virtual keyboard. This is useful for custom input controls.\n* `text`: Standard text input keyboard.\n* `decimal`: Decimal input keyboard. This includes a period `.` or comma `,` and numbers.\n* `numeric`: Numeric keyboard. This displays numbers 0-9.\n* `tel`: Phone number keyboard. This includes numbers 0-9, asterisk `*`, and hash `#` keys.\n* `search`: Search-optimized virtual keyboard. 'Search' is displayed on the submit button.\n* `email`: Email-optimized virtual keyboard. This typically includes `@ .`.\n* `url`: URL-optimized virtual keyboard. This typically includes `. / #`.",
+          "description": "Customizes the virtual keyboard. Possible values:\n\n* `none`: No virtual keyboard. Useful for custom input controls.\n* `text`: Standard text input keyboard.\n* `decimal`: Decimal input keyboard. This includes a period `.` or comma `,` and numbers.\n* `numeric`: Numeric keyboard. This displays numbers 0–9.\n* `tel`: Phone number keyboard. This includes numbers 0–9, asterisk `*`, and hash `#` keys.\n* `search`: Search-optimized virtual keyboard. 'Search' appears on the submit button.\n* `email`: Email-optimized virtual keyboard. This typically includes `@` and `.`.\n* `url`: URL-optimized virtual keyboard. This typically includes `.`, `/`, and `#`.",
           "values": [
             {
               "name": "none",
@@ -6158,23 +6158,23 @@
             },
             {
               "name": "numeric",
-              "description": "Numeric keyboard. This displays numbers 0-9."
+              "description": "Numeric keyboard. This displays numbers 0–9."
             },
             {
               "name": "tel",
-              "description": "Phone number keyboard. This includes numbers 0-9, asterisk `*`, and hash `#` keys."
+              "description": "Phone number keyboard. This includes numbers 0–9, asterisk `*`, and hash `#` keys."
             },
             {
               "name": "search",
-              "description": "Search-optimized virtual keyboard. 'Search' is displayed on the submit button."
+              "description": "Search-optimized virtual keyboard. 'Search' appears on the submit button."
             },
             {
               "name": "email",
-              "description": "Email-optimized virtual keyboard. This typically includes `@ .`."
+              "description": "Email-optimized virtual keyboard. This typically includes `@` and `.`."
             },
             {
               "name": "url",
-              "description": "URL-optimized virtual keyboard. This typically includes `. / #`."
+              "description": "URL-optimized virtual keyboard. This typically includes `.`, `/`, and `#`."
             }
           ],
           "references": [
@@ -6186,7 +6186,7 @@
         },
         {
           "name": "autofocus",
-          "description": "Determines if the element should be focused when the page loads.",
+          "description": "Whether the element is focused when the page loads.",
           "references": [
             {
               "name": "Docs",
@@ -6196,7 +6196,7 @@
         },
         {
           "name": "tabindex",
-          "description": "Specifies the order in which the element receives focus when navigating with the Tab key.",
+          "description": "The element's tab order when navigating with the Tab key.",
           "references": [
             {
               "name": "Docs",
@@ -6222,15 +6222,15 @@
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the tooltip shape. Default is `plain`. Possible values:\n\n* `plain`: For simple single-line text.\n* `rich`: For text including a title, body text, and action buttons.",
+          "description": "Defines the tooltip variant. Default is `plain`. Possible values:\n\n* `plain`: For simple, single-line text.\n* `rich`: For tooltips with a title, body text, and action buttons.",
           "values": [
             {
               "name": "plain",
-              "description": "For simple single-line text."
+              "description": "For simple, single-line text."
             },
             {
               "name": "rich",
-              "description": "For text including a title, body text, and action buttons."
+              "description": "For tooltips with a title, body text, and action buttons."
             }
           ],
           "references": [
@@ -6242,7 +6242,7 @@
         },
         {
           "name": "placement",
-          "description": "Sets the tooltip position. Default is `auto`. Possible values:\n\n* `auto`: Position is determined automatically.\n* `top-left`: Top-left corner.\n* `top-start`: Top, left-aligned.\n* `top`: Top, centered.\n* `top-end`: Top, right-aligned.\n* `top-right`: Top-right corner.\n* `bottom-left`: Bottom-left corner.\n* `bottom-start`: Bottom, left-aligned.\n* `bottom`: Bottom, centered.\n* `bottom-end`: Bottom, right-aligned.\n* `bottom-right`: Bottom-right corner.\n* `left-start`: Left, top-aligned.\n* `left`: Left, centered.\n* `left-end`: Left, bottom-aligned.\n* `right-start`: Right, top-aligned.\n* `right`: Right, centered.\n* `right-end`: Right, bottom-aligned.",
+          "description": "Sets the tooltip position. Default is `auto`. Possible values:\n\n* `auto`: Automatically determined. For `variant=\"plain\"`, prefers `top`; for `variant=\"rich\"`, prefers `bottom-right`.\n* `top-left`: Top left.\n* `top-start`: Top start.\n* `top`: Top center.\n* `top-end`: Top end.\n* `top-right`: Top right.\n* `bottom-left`: Bottom left.\n* `bottom-start`: Bottom start.\n* `bottom`: Bottom center.\n* `bottom-end`: Bottom end.\n* `bottom-right`: Bottom right.\n* `left-start`: Left start.\n* `left`: Left center.\n* `left-end`: Left end.\n* `right-start`: Right start.\n* `right`: Right center.\n* `right-end`: Right end.",
           "values": [
             {
               "name": "auto",
@@ -6250,67 +6250,67 @@
             },
             {
               "name": "top-left",
-              "description": "Top-left corner."
+              "description": "Top left."
             },
             {
               "name": "top-start",
-              "description": "Top, left-aligned."
+              "description": "Top start."
             },
             {
               "name": "top",
-              "description": "Top, centered."
+              "description": "Top center."
             },
             {
               "name": "top-end",
-              "description": "Top, right-aligned."
+              "description": "Top end."
             },
             {
               "name": "top-right",
-              "description": "Top-right corner."
+              "description": "Top right."
             },
             {
               "name": "bottom-left",
-              "description": "Bottom-left corner."
+              "description": "Bottom left."
             },
             {
               "name": "bottom-start",
-              "description": "Bottom, left-aligned."
+              "description": "Bottom start."
             },
             {
               "name": "bottom",
-              "description": "Bottom, centered."
+              "description": "Bottom center."
             },
             {
               "name": "bottom-end",
-              "description": "Bottom, right-aligned."
+              "description": "Bottom end."
             },
             {
               "name": "bottom-right",
-              "description": "Bottom-right corner."
+              "description": "Bottom right."
             },
             {
               "name": "left-start",
-              "description": "Left, top-aligned."
+              "description": "Left start."
             },
             {
               "name": "left",
-              "description": "Left, centered."
+              "description": "Left center."
             },
             {
               "name": "left-end",
-              "description": "Left, bottom-aligned."
+              "description": "Left end."
             },
             {
               "name": "right-start",
-              "description": "Right, top-aligned."
+              "description": "Right start."
             },
             {
               "name": "right",
-              "description": "Right, centered."
+              "description": "Right center."
             },
             {
               "name": "right-end",
-              "description": "Right, bottom-aligned."
+              "description": "Right end."
             }
           ],
           "references": [
@@ -6322,7 +6322,7 @@
         },
         {
           "name": "open-delay",
-          "description": "Sets the delay in milliseconds before the tooltip appears on hover.",
+          "description": "The delay (in milliseconds) before the tooltip appears on hover.",
           "references": [
             {
               "name": "Docs",
@@ -6332,7 +6332,7 @@
         },
         {
           "name": "close-delay",
-          "description": "Sets the delay in milliseconds before the tooltip disappears on hover.",
+          "description": "The delay (in milliseconds) before the tooltip disappears on hover.",
           "references": [
             {
               "name": "Docs",
@@ -6342,7 +6342,7 @@
         },
         {
           "name": "headline",
-          "description": "Sets the tooltip title. Only applicable when `variant=\"rich\"`. Alternatively, use `slot=\"headline\"`.",
+          "description": "Sets the tooltip title. Only applies when `variant=\"rich\"`. Alternatively, use `slot=\"headline\"`.",
           "references": [
             {
               "name": "Docs",
@@ -6362,23 +6362,23 @@
         },
         {
           "name": "trigger",
-          "description": "Defines the trigger method. Supports multiple values separated by spaces. Possible values:\n\n* `click`: Triggered on click.\n* `hover`: Triggered on mouse hover.\n* `focus`: Triggered on focus.\n* `manual`: Can only open and close the tooltip programmatically, cannot specify other trigger methods.",
+          "description": "Defines how the tooltip opens. Multiple space-separated values are supported. Possible values:\n\n* `click`: Triggers on click.\n* `hover`: Triggers on mouse hover.\n* `focus`: Triggers on focus.\n* `manual`: Can only be opened and closed programmatically; no other trigger methods can be specified.",
           "values": [
             {
               "name": "click",
-              "description": "Triggered on click."
+              "description": "Triggers on click."
             },
             {
               "name": "hover",
-              "description": "Triggered on mouse hover."
+              "description": "Triggers on mouse hover."
             },
             {
               "name": "focus",
-              "description": "Triggered on focus."
+              "description": "Triggers on focus."
             },
             {
               "name": "manual",
-              "description": "Can only open and close the tooltip programmatically, cannot specify other trigger methods."
+              "description": "Can only be opened and closed programmatically; no other trigger methods can be specified."
             }
           ],
           "references": [
@@ -6422,7 +6422,7 @@
     },
     {
       "name": "mdui-top-app-bar-title",
-      "description": "Top App Bar Title Component  It should be used in conjunction with the `<mdui-top-app-bar>` component \n\n```html\n<mdui-top-app-bar>\n  <mdui-button-icon icon=\"menu\"></mdui-button-icon>\n  <mdui-top-app-bar-title>Title</mdui-top-app-bar-title>\n  <div style=\"flex-grow: 1\"></div>\n  <mdui-button-icon icon=\"more_vert\"></mdui-button-icon>\n</mdui-top-app-bar>\n```",
+      "description": "Top App Bar Title Component  Use with the `<mdui-top-app-bar>` component \n\n```html\n<mdui-top-app-bar>\n  <mdui-button-icon icon=\"menu\"></mdui-button-icon>\n  <mdui-top-app-bar-title>Title</mdui-top-app-bar-title>\n  <div style=\"flex-grow: 1\"></div>\n  <mdui-button-icon icon=\"more_vert\"></mdui-button-icon>\n</mdui-top-app-bar>\n```",
       "attributes": [],
       "references": [
         {
@@ -6441,11 +6441,11 @@
       "attributes": [
         {
           "name": "variant",
-          "description": "Defines the top app bar style. Default is `small`. Possible values:\n\n* `center-aligned`: Small app bar with a center-aligned title.\n* `small`: Small app bar.\n* `medium`: Medium-sized app bar.\n* `large`: Large-sized app bar.",
+          "description": "Defines the top app bar variant. Default is `small`. Possible values:\n\n* `center-aligned`: A small app bar with a centered title.\n* `small`: Small app bar.\n* `medium`: Medium-sized app bar.\n* `large`: Large-sized app bar.",
           "values": [
             {
               "name": "center-aligned",
-              "description": "Small app bar with a center-aligned title."
+              "description": "Small app bar with a centered title."
             },
             {
               "name": "small",
@@ -6469,7 +6469,7 @@
         },
         {
           "name": "hide",
-          "description": "Hide the top app bar.",
+          "description": "Whether the top app bar is hidden.",
           "references": [
             {
               "name": "Docs",
@@ -6479,7 +6479,7 @@
         },
         {
           "name": "shrink",
-          "description": "Shrinks the app bar to `small` style. Only applicable for `medium` or `large` variants.",
+          "description": "Shrinks the app bar to the `small` variant. Only applies to `medium` or `large` variants.",
           "references": [
             {
               "name": "Docs",
@@ -6489,7 +6489,7 @@
         },
         {
           "name": "scroll-behavior",
-          "description": "Defines the scroll behavior. Accepts multiple space-separated values. Possible values:\n\n* `hide`: Hides when scrolling.\n* `shrink`: Shrinks when scrolling for medium to large app bars.\n* `elevate`: Increases elevation when scrolling.",
+          "description": "Defines the scroll behavior. Multiple space-separated values are accepted. Possible values:\n\n* `hide`: Hides when scrolling.\n* `shrink`: Shrinks when scrolling (for medium to large app bars).\n* `elevate`: Increases elevation when scrolling.",
           "values": [
             {
               "name": "hide"
@@ -6510,7 +6510,7 @@
         },
         {
           "name": "scroll-target",
-          "description": "The element that listens for scroll events. Accepts a CSS selector, DOM element, or [JQ object](https://www.mdui.org/en/docs/2/functions/jq). Defaults to `window`.",
+          "description": "The element to watch for scroll events. Accepts a CSS selector, a DOM element, or a [JQ object](/en/docs/2/functions/jq). Defaults to `window`.",
           "references": [
             {
               "name": "Docs",
@@ -6520,7 +6520,7 @@
         },
         {
           "name": "scroll-threshold",
-          "description": "The scroll distance (in pixels) that triggers the scroll behavior.",
+          "description": "The scroll distance (in pixels) required to trigger the scroll behavior.",
           "references": [
             {
               "name": "Docs",
@@ -6530,7 +6530,7 @@
         },
         {
           "name": "order",
-          "description": "Specifies the layout order within the [`<mdui-layout>`](https://www.mdui.org/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
+          "description": "Specifies the layout order within the [`<mdui-layout>`](/en/docs/2/components/layout) component. Items are sorted in ascending order. The default value is `0`.",
           "references": [
             {
               "name": "Docs",