diff --git a/menu/README.md b/menu/README.md
index e69de29..190d8d9 100644
--- a/menu/README.md
+++ b/menu/README.md
@@ -0,0 +1,24 @@
+# Menu items
+
+The menu definitions are stored in files which
+are processed by the server based controller, which returns
+the list of entitled menus to the web browser which then
+displays them according to its style.
+
+## Self Serve
+
+If you edit the [menu_selfserve.json](menu_selfserve.json) file, you 
+can see the changes in the web side after update / refresh immeditaley.
+
+If you do change the file start slowly such as changing:
+
+* label
+* intent (try a different web location)
+
+It is easy to corrupt the JSON file with wrong format, so
+caution is advised.
+
+If you feel confident, you can add a new item, and when
+doing so please select a function id that already exists
+because otherwise the menu item is unlikely to appear due to
+the entitlement check.