polish JSDoc

vursen · vursen · commit 4ae12c5ae4c3 · 2025-01-20T11:15:46.000+04:00
diff --git a/packages/menu-bar/src/vaadin-menu-bar-mixin.d.ts b/packages/menu-bar/src/vaadin-menu-bar-mixin.d.ts
@@ -103,12 +103,12 @@ export declare class MenuBarMixinClass {
    * #### Disabled items
    *
    * When an item is disabled, it prevents any user interaction with it, such as
-   * focusing, clicking, opening a sub-menu, etc. The item is also removed from the
-   * tab order, which may negatively impact accessibility.
+   * focusing, clicking, opening a sub-menu, etc. The item is also removed from
+   * tab order, which makes it inaccessible to screen readers.
    *
    * To improve accessibility, disabled root-level items (menu bar buttons) can be
-   * made focusable so that screen readers can reach and properly announce them to
-   * users, while still preventing clicks. This is currently available as an
+   * made focusable so that screen readers can still reach and properly announce
+   * them, while still preventing clicks. This is currently available as an
    * experimental enhancement that can be enabled with the following feature flag:
    *
    * ```
diff --git a/packages/menu-bar/src/vaadin-menu-bar-mixin.js b/packages/menu-bar/src/vaadin-menu-bar-mixin.js
@@ -81,12 +81,12 @@ export const MenuBarMixin = (superClass) =>
          * #### Disabled items
          *
          * When an item is disabled, it prevents any user interaction with it, such as
-         * focusing, clicking, opening a sub-menu, etc. The item is also removed from the
-         * tab order, which may negatively impact accessibility.
+         * focusing, clicking, opening a sub-menu, etc. The item is also removed from
+         * tab order, which makes it inaccessible to screen readers.
          *
          * To improve accessibility, disabled root-level items (menu bar buttons) can be
-         * made focusable so that screen readers can reach and properly announce them to
-         * users, while still preventing clicks. This is currently available as an
+         * made focusable so that screen readers can still reach and properly announce
+         * them, while still preventing clicks. This is currently available as an
          * experimental enhancement that can be enabled with the following feature flag:
          *
          * ```

Original file line number	Diff line number	Diff line change
`@@ -103,12 +103,12 @@ export declare class MenuBarMixinClass {`
`103`	`103`	`* #### Disabled items`
`104`	`104`	`*`
`105`	`105`	`* When an item is disabled, it prevents any user interaction with it, such as`
`106`		`- * focusing, clicking, opening a sub-menu, etc. The item is also removed from the`
`107`		`- * tab order, which may negatively impact accessibility.`
	`106`	`+ * focusing, clicking, opening a sub-menu, etc. The item is also removed from`
	`107`	`+ * tab order, which makes it inaccessible to screen readers.`
`108`	`108`	`*`
`109`	`109`	`* To improve accessibility, disabled root-level items (menu bar buttons) can be`
`110`		`- * made focusable so that screen readers can reach and properly announce them to`
`111`		`- * users, while still preventing clicks. This is currently available as an`
	`110`	`+ * made focusable so that screen readers can still reach and properly announce`
	`111`	`+ * them, while still preventing clicks. This is currently available as an`
`112`	`112`	`* experimental enhancement that can be enabled with the following feature flag:`
`113`	`113`	`*`
`114`	`114`	* ```
Original file line number	Diff line number	Diff line change
`@@ -81,12 +81,12 @@ export const MenuBarMixin = (superClass) =>`
`81`	`81`	`* #### Disabled items`
`82`	`82`	`*`
`83`	`83`	`* When an item is disabled, it prevents any user interaction with it, such as`
`84`		`- * focusing, clicking, opening a sub-menu, etc. The item is also removed from the`
`85`		`- * tab order, which may negatively impact accessibility.`
	`84`	`+ * focusing, clicking, opening a sub-menu, etc. The item is also removed from`
	`85`	`+ * tab order, which makes it inaccessible to screen readers.`
`86`	`86`	`*`
`87`	`87`	`* To improve accessibility, disabled root-level items (menu bar buttons) can be`
`88`		`- * made focusable so that screen readers can reach and properly announce them to`
`89`		`- * users, while still preventing clicks. This is currently available as an`
	`88`	`+ * made focusable so that screen readers can still reach and properly announce`
	`89`	`+ * them, while still preventing clicks. This is currently available as an`
`90`	`90`	`* experimental enhancement that can be enabled with the following feature flag:`
`91`	`91`	`*`
`92`	`92`	* ```