update Select

Author: MarcusNotheis

packages/main/src/webComponents/Select/SelectDescription.md

@@ -1,3 +1,12 @@
+## Usage
+
+There are two main usages of the `Select`.
+
+1. With Option (`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 SelectMenu (`SelectMenu`) and SelectMenuOption (`SelectMenuOption`) web components:  
+   The SelectMenu can be used as alternative to define the Select's dropdown and can be used via the `menu` property of the Select to reference SelectMenu by its ID. The component gives the possibility to customize the Select's dropdown by slotting entirely custom options (via the SelectMenuOption component) and adding custom styles. **Note:** SelectMenu is a popover and placing it top-level in the HTML page is recommended, because some page styles (for example transitions) can misplace the SelectMenu.
+
 ## Keyboard Handling
 
 The `Select` provides advanced keyboard handling.

packages/main/src/webComponents/Select/index.tsx

@@ -126,7 +126,7 @@ export interface SelectPropTypes extends SelectAttributes, Omit<CommonProps, 'on
 }
 
 /**
- * The `Select` component is used to create a drop-down list. The items inside the `Select` define the available options by using the `Option` component.
+ * The `Select` component is used to create a drop-down list.
  *
  * __Note:__ This component is a web component developed by the UI5 Web Components’ team.
  *