chore: api and docs improvements (#11179)

Author: ilhan007

packages/fiori/src/ShellBarItem.ts

@@ -81,6 +81,10 @@ class ShellBarItem extends UI5Element {
 	 * - **hasPopup**: Indicates the availability and type of interactive popup element,
 	 * such as menu or dialog, that can be triggered by the button.
 	 *
+	 * - **controls**: Identifies the element (or elements) whose contents
+	 * or presence are controlled by the component.
+	 * Accepts a lowercase string value, referencing the ID of the element it controls.
+	 *
 	 * @default {}
 	 * @public
 	 * @since 2.9.0

packages/main/src/MultiComboBox.ts

@@ -645,15 +645,6 @@ class MultiComboBox extends UI5Element implements IFormInputElement {
 		this.selectedItems = this._getItems().filter((item, idx, allItems) => MultiComboBox._groupItemFilter(item, ++idx, allItems, selectedItems) || selectedItems.indexOf(item) !== -1);
 	}
 
-	/**
-	 * Indicates whether the dropdown is open. True if the dropdown is open, false otherwise.
-	 * @default false
-	 * @public
-	 */
-	get isOpen(): boolean {
-		return this.open;
-	}
-
 	get _showAllItemsButtonPressed(): boolean {
 		return this.filterSelected;
 	}

packages/main/src/Select.ts

@@ -93,17 +93,18 @@ type SelectLiveChangeEventDetail = {
  *
  * There are two main usages of the `ui5-select>`.
  *
- * 1. With Option (`ui5-option`) web component:
+ * - With Option (`ui5-option`) web component:
  *
  * The available options of the Select are defined by using the Option component.
  * The Option comes with predefined design and layout, including `icon`, `text` and `additional-text`.
  *
- * 2. With OptionCustom (`ui5-option-custom`) web component.
+ * - With OptionCustom (`ui5-option-custom`) web component.
  *
  * Options with custom content are defined by using the OptionCustom component
  * The OptionCustom component comes with no predefined layout and it expects consumers to define it.
  *
  * ### Keyboard Handling
+ *
  * The `ui5-select` provides advanced keyboard handling.
  *
  * - [F4] / [Alt] + [Up] / [Alt] + [Down] / [Space] or [Enter] - Opens/closes the drop-down.
@@ -114,6 +115,7 @@ type SelectLiveChangeEventDetail = {
  * - [End] - Navigates to the last option
  *
  * ### ES6 Module Import
+ *
  * `import "@ui5/webcomponents/dist/Select";`
  *
  * `import "@ui5/webcomponents/dist/Option";`
@@ -216,14 +218,17 @@ class Select extends UI5Element implements IFormInputElement {
 
 	/**
 	 * Defines the icon, displayed as graphical element within the component.
+	 * When set, the component will display the icon only - the selected option's text,
+	 * the Select's "label" slot (if present) and the dropdown arrow won't be displayed.
+	 *
 	 * The SAP-icons font provides numerous options.
 	 *
 	 * Example:
 	 * See all the available icons within the [Icon Explorer](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html).
 	 *
 	 * **Note:** When using this property with a valid icon, Select will be rendered as icon only button and the label and the default arrow down won't be visible.
 	 * @default undefined
-	 * @public
+	 * @private
 	 */
 	@property()
 	icon?: string;

packages/website/docs/_components_pages/main/Select/Select.mdx

@@ -6,7 +6,6 @@ import Basic from "../../../_samples/main/Select/Basic/Basic.md";
 import States from "../../../_samples/main/Select/States/States.md";
 import AdditionalText from "../../../_samples/main/Select/AdditionalText/AdditionalText.md";
 import CustomOptions from "../../../_samples/main/Select/CustomOptions/CustomOptions.md";
-import IconOnly from "../../../_samples/main/Select/IconOnly/IconOnly.md";
 
 <%COMPONENT_OVERVIEW%>
 
@@ -32,9 +31,4 @@ Options can dispplay additional text.
 ### Custom Options
 You can define completely custom options via the ui5-option-custom (providing custom content) component.
 
-<CustomOptions />
-
-### Icon only
-You can define select as icon only with the help of its icon property.
-
-<IconOnly />
+<CustomOptions />