:memo: Add note regarding dynamic addition/removal of menu items.

Closes #8928.

[ci skip]

diff --git a/docs/api/menu.md b/docs/api/menu.md
index cd68176..ad846fb 100644 (file)
--- a/docs/api/menu.md
+++ b/docs/api/menu.md
@@ -25,6 +25,10 @@ will be set as each window's top menu.
 
 Returns `Menu` - The application menu, if set, or `null`, if not set.
 
+**Note:** The returned `Menu` instance doesn't support dynamic addition or
+removal of menu items. [Instance properties](#instance-properties) can still
+be dynamically modified.
+
 #### `Menu.sendActionToFirstResponder(action)` _macOS_
 
 * `action` String