Update for suggestions

Author: xDeSwa

src/Icons/doc/index.rst

@@ -481,41 +481,45 @@ of the following attributes: ``aria-label``, ``aria-labelledby`` or ``title``.
 
         <twig:ux:icon name="user-profile" aria-hidden="false" />
 
-## Accessibility: Descriptive Titles and Descriptions
+**Accessibility: Descriptive Titles and Descriptions**
 
-.. versionadded:: NEXT\_VERSION
+.. versionadded:: 2.28
 
-The `ux_icon()` function and the `<twig:ux:icon>` component now support accessible SVG metadata via the `title` and `desc` attributes.
+The `ux_icon()` function and the `<twig:ux:icon>` component now support accessible SVG metadata via the `title` and `desc` attributes in 2.28.
 
-These are automatically injected into the `<svg>` markup as child elements, and properly referenced using `aria-labelledby` for improved screen reader support.
+These are automatically injected into the ``<svg>`` markup as child elements, and properly referenced using ``aria-labelledby`` for improved screen reader support.
 
 **How it works:**
 
 When you pass a `title` and/or `desc` attribute, they are rendered inside the `<svg>` as follows:
 
 .. code-block:: html+twig
 
-```
 {{ ux_icon('bi:plus-square-dotted', {
     width: '16px',
     height: '16px',
     class: 'text-success',
     title: 'Add Stock',
     desc: 'This icon indicates stock entry functionality.'
 }) }}
-```
 
 Renders:
 
 .. code-block:: html
 
-```
 <svg class="text-success" width="16px" height="16px" aria-labelledby="icon-title-abc icon-desc-def">
     <title id="icon-title-abc">Add Stock</title>
     <desc id="icon-desc-def">This icon indicates stock entry functionality.</desc>
     <!-- inner SVG content -->
 </svg>
-```
+
+.. note::
+
+    - If ``aria-labelledby`` is already defined in your attributes, it will **not** be overwritten.
+    - ``role="img"`` is **not added automatically**. You may choose to include it if your use case requires.
+    - When neither ``title``, ``desc``, ``aria-label``, nor ``aria-labelledby`` are provided, ``aria-hidden="true"`` will still be automatically applied.
+
+This feature brings UX Icons in line with modern accessibility recommendations and helps developers build more inclusive user interfaces.
 
 To learn more about accessible SVG elements: