update mentions comments

src/components/MentionSuggestions.tsx

@@ -12,16 +12,26 @@ import Avatar from './Avatar';
 import Text from './Text';
 
 type Mention = {
-    /** Display name of the mention */
+    /**
+     * Main display text of the mention
+     * always visible right after icon (if present)
+     */
     text: string;
 
-    /** The formatted text of the mention */
+    /**
+     * additional text for the mention
+     * visible if it's value is different than Mention.text value
+     * rendered after Mention.text
+     */
     alternateText: string;
 
-    /** handle of the mention */
+    /**
+     * handle of the mention
+     * used as a value for the mention (e.g. in for the filtering or putting the mention in the message)
+     */
     handle?: string;
 
-    /** Array of icons of the user. If present, we use the first element of this array. For room suggestions, the icons are not used */
+    /** Array of icons of the mention. If present, we use the first element of this array. For room suggestions, the icons are not used */
     icons?: Icon[];
 };