docs(Toolbar): replace deprecation annotation with a note (#5101)

Author: Lukas742

packages/main/src/components/Toolbar/index.tsx

@@ -126,6 +126,11 @@ export interface ToolbarPropTypes extends Omit<CommonProps, 'onClick' | 'childre
 const OVERFLOW_BUTTON_WIDTH = 36 + 8 + 8; // width + padding end + spacing start
 
 /**
+ *
+ * __Note:__ The `Toolbar` component may be replaced by the `ui5-toolbar` web-component (currently available as `ToolbarV2`) with our next major release. If you only need to pass components supported by `ToolbarV2` then please consider using `ToolbarV2` instead of this component.
+ *
+ * ___
+ *
  * Horizontal container most commonly used to display buttons, labels, selects and various other input controls.
  *
  * The content of the `Toolbar` moves into the overflow area from right to left when the available space is not enough in the visible area of the container.
@@ -134,8 +139,6 @@ const OVERFLOW_BUTTON_WIDTH = 36 + 8 + 8; // width + padding end + spacing start
  * __Note:__ The overflow popover is mounted only when the overflow button is displayed, i.e., any child component of the popover will be remounted, when moved into it.
  *
  * __Note:__ To prevent duplicate child `id`s in the DOM, all child `id`s get an `-overflow` suffix. This is especially important when popovers are opened by id.
- *
- * @deprecated This component will be replaced by the `ui5-toolbar` web-component (currently available as `ToolbarV2`) with our next major release. Please use `ToolbarV2` instead.
  */
 const Toolbar = forwardRef<HTMLDivElement, ToolbarPropTypes>((props, ref) => {
   const {

packages/main/src/components/ToolbarSeparator/index.tsx

@@ -22,7 +22,7 @@ export type ToolbarSeparatorPropTypes = CommonProps;
 /**
  * Creates a visual separator between the preceding and succeeding `Toolbar` item.
  *
- * @deprecated This component is only compatible with the deprecated `Toolbar` component and __not__ with `ToolbarV2`. If you're using `ToolbarV2`, please use `ToolbarSeparatorV2` instead.
+ * __Note:__ This component is only compatible with the `Toolbar` component and __not__ with `ToolbarV2`. If you're using `ToolbarV2`, please use `ToolbarSeparatorV2` instead.
  */
 const ToolbarSeparator = forwardRef<HTMLDivElement, ToolbarSeparatorPropTypes>((props, ref) => {
   const { style, className, ...rest } = props;

packages/main/src/components/ToolbarSpacer/index.tsx

@@ -5,7 +5,7 @@ export type ToolbarSpacerPropTypes = CommonProps;
 /**
  * Adds horizontal space between the items used within a `Toolbar`.
  *
- * @deprecated This component is only compatible with the deprecated `Toolbar` component and __not__ with `ToolbarV2`. If you're using `ToolbarV2`, please use `ToolbarSpacerV2` instead.
+ * __Note:__ This component is only compatible with the `Toolbar` component and __not__ with `ToolbarV2`. If you're using `ToolbarV2`, please use `ToolbarSpacerV2` instead.
  */
 const ToolbarSpacer = forwardRef<HTMLSpanElement, ToolbarSpacerPropTypes>((props, ref) => {
   return <span ref={ref} style={{ flexGrow: 1 }} className="spacer" {...props} />;