From a92f639b64cb8d16e91228da54e449a4dc0a316d Mon Sep 17 00:00:00 2001
From: Cory Reed <creed@mrn.org>
Date: Thu, 23 Mar 2017 11:55:46 -0700
Subject: [PATCH] :memo: Add note regarding dynamic addition/removal of menu
 items.

Closes #8928.

[ci skip]
---
 docs/api/menu.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/api/menu.md b/docs/api/menu.md
index cd6817625a..ad846fb84d 100644
--- 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