From 403568b254ff1f219176a93087864136fb3513c2 Mon Sep 17 00:00:00 2001
From: Rachel Bratt Tannenbaum <rachelbt@users.noreply.github.com>
Date: Sun, 1 Dec 2024 16:33:47 +0200
Subject: [PATCH] chore(menu): add note about placement bottom (VIV-2223)
 (#2035)

---
 libs/components/src/lib/menu/README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/libs/components/src/lib/menu/README.md b/libs/components/src/lib/menu/README.md
index 644399f915..225e744871 100644
--- a/libs/components/src/lib/menu/README.md
+++ b/libs/components/src/lib/menu/README.md
@@ -102,6 +102,14 @@ Use the `placement` attribute to control the position of the menu relative to it
 - Type: `'top'` | `'top-start'` | `'top-end'` | `'right'` | `'right-start'` | `'right-end'` | `'bottom'` | `'bottom-start'` | `'bottom-end'`| `'left'` | `'left-start'`| `'left-end'`
 - Default: `'bottom'`
 
+<vwc-note connotation="warning" icon="warning-line" headline="Bottom Placement at Viewport side">
+
+When the menu anchor is placed close to the start/end of the viewport, `placement` of `bottom` or `top` will not present well due to lack of space.
+
+In such cases - prefer using `bottom-start` or `end` instead.
+
+</vwc-note>
+
 ```html preview 150px
 <div style="position: relative; text-align: end;">
 	<vwc-menu