--- a/MenuItem.st	Thu Jan 18 20:32:51 2018 +0100
+++ b/MenuItem.st	Fri Jan 19 10:43:10 2018 +0100
@@ -663,12 +663,18 @@
 !
 
 uuid
+    "return my uuid component to be used for resource-access.
+     This is a unique and once-assigned-never-changed uuid by which
+     UI automators can access the menu item."
 
     ^ uuid
 !
 
 uuid:aUUID
-    "return my name component to be used for resource-access"
+    "set my uuid component to be used for resource-access
+     (called by menuBuilder).
+     This is a unique and once-assigned-never-changed uuid by which
+     UI automators can access the menu item."
 
     uuid := aUUID
 ! !