docs(ui5-side-navigation-item): update documentation (#11659)

* docs(ui5-side-navigation-item): updated documentation

---------

Co-authored-by: Teodor Taushanov <[email protected]>

Author: GerganaKremenska

packages/fiori/src/SideNavigationSelectableItemBase.ts

@@ -57,7 +57,9 @@ class SideNavigationSelectableItemBase extends SideNavigationItemBase {
 	icon?: string;
 
 	/**
-	 * Defines whether the item is selected
+	 * Defines whether the item is selected.
+	 *
+	 * **Note:** Items that have a set `href` and `target` set to `_blank` should not be selectable.
 	 *
 	 * @public
 	 * @default false
@@ -81,15 +83,16 @@ class SideNavigationSelectableItemBase extends SideNavigationItemBase {
 	/**
 	 * Defines the component target.
 	 *
-	 * **Notes:**
+	 * Possible values:
 	 *
 	 * - `_self`
 	 * - `_top`
 	 * - `_blank`
 	 * - `_parent`
-	 * - `_search`
+	 * - `framename`
 	 *
-	 * **This property must only be used when the `href` property is set.**
+	 * **Note:** Items that have a defined `href` and `target`
+	 * attribute set to `_blank` should not be selectable.
 	 *
 	 * @public
 	 * @default undefined
@@ -111,15 +114,15 @@ class SideNavigationSelectableItemBase extends SideNavigationItemBase {
 	design: `${SideNavigationItemDesign}` = "Default";
 
 	/**
-	 * Indicates whether the navigation item is selectable. By default all items are selectable unless specifically marked as unselectable.
+	 * Indicates whether the navigation item is selectable. By default, all items are selectable unless specifically marked as unselectable.
 	 *
 	 * When a parent item is marked as unselectable, selecting it will only expand or collapse its sub-items.
 	 * To improve user experience do not mix unselectable parent items with selectable parent items in a single side navigation.
 	 *
 	 *
 	 * **Guidelines**:
-	 * - External links should be unselectable.
-	 * - Items that trigger actions (with design "Action") should be unselectable.
+	 * - Items with an assigned `href` and a target of `_blank` should be marked as unselectable.
+	 * - Items that trigger actions (with design "Action") should be marked as unselectable.
 	 *
 	 * @public
 	 * @default false