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

[GerganaKremenska]

Document the correct usage recommendations for external link items: use the target=_blank attribute along with the href property.

JIRA: BGSOFUIRODOPI-3487

[Copilot]

Pull Request Overview

This PR enhances the JSDoc comments for SideNavigationSelectableItemBase to clarify how href, target, selection, and child items should interact.

• Refined description of the selected property and its relation to href/target="_blank".
• Added guidance on children usage when href and target are set.
• Clarified recommended target usage for internal navigation.

Comments suppressed due to low confidence (2)

packages/fiori/src/SideNavigationSelectableItemBase.ts:62

• [nitpick] Consider rephrasing for clarity, e.g., "Items with an href and target="_blank" are not selectable." to make the statement more concise and consistent with other JSDoc entries.

* Items that have a set href and target set to <code>_blank</code> should not be selectable.

packages/fiori/src/SideNavigationSelectableItemBase.ts:96

• [nitpick] This sentence is a bit unclear. You could simplify it to: "Items with an href should not specify a target for internal navigation." to better convey the intended restriction.

* **Items that have a set href, should not use target for internal navigation.**

[Stoev]

Please change the header to:

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

Please consider changing the additional explanation below the header:

Document the correct usage recommendations for external link items: use the target=_blank attribute along with the href property.

[TeodorTaushanov]

Please change the header to:

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

Please consider changing the additional explanation below the header:

Document the correct usage recommendations for external link items: use the target=_blank attribute along with the href property.

Done

[Stoev]

Looks good, thank you.