mention

• MentionsMacro, xwiki-platform: a wiki macro with no content, whose parameters declare no constraint and whose code reads the unset anchor as unexpanded Velocity text.
• Mentions Application: the only documentation, with the dedicated "Mention" Quick Actions entry that inserts the macro with a generated anchor.
• The uses of the macro in XWiki Standard are tests only, MentionsIT, QuickActionsIT and NotificationsEmailsIT, which call it with a reference, a style and an anchor.

C1, minor: the label "Reference" is a developer word for a field that picks a person, and the useravatar macro calls the same thing "Username". The description "The mentioned user or group reference." speaks of groups, which the picker does not offer: searching "Group" or "XWikiAdminGroup" lists nothing.

C2: mandatory with no default, which is right: the mentioned user is the whole purpose of the macro.

C3: N/A, mandatory and without a default.

C4: a user picker, titled "Pick a user.". It lists Administrator and John Doe when opened, "Adm" lists Administrator and "John" lists John Doe. Picking a user writes reference="XWiki.Admin" . Groups cannot be found.

C5: Reference is outside any group, the three other fields are in the Optional parameters tab.

C6: Reference, set in the most common example, comes first.

C13: N/A, the accepted values are the users of the wiki, picked from a list.

C1: "Display Style" with the options "Full name of the user" and the like says what it changes.

C2: optional with a default.

C3: the field opens on the declared default FULL_NAME, the value of the most common example.

C4: a select with the three styles.

C5: in the Optional parameters tab, with two other fields.

C6: set in the most common example, after Anchor and before Type, which the example does not set.

C8: set in the most common example, and not advanced.

C9: set in the documentation examples.

C13: N/A, a select, so the dialog cannot produce an invalid value, see E2 for the source.

C1, minor: "The anchor to be used for linking to that mention (this anchor should be unique to the document as much as possible)." does not say what the anchor is for, what an empty value does, nor how to choose a unique one. The documentation suggests a random string from random.org.

C2: optional, as the macro renders with no anchor.

C3: the field opens empty, and the examples set a different value for each mention, like xwiki-XWiki.Admin-123456, so no single default exists. The dedicated "Mention" entry generates one, like XWiki-Admin-quqyis, which the dialog could preselect. An empty anchor gives the id $escapetool.xml($anchor) unexpanded, see E2.

C4: a plain text field for an identifier, no picker applies.

C5: in the Optional parameters tab, with two other fields.

C6: set in the most common example, comes first in the tab, before Display Style.

C8: set in the most common example, but a value that the editor generates and that users do not choose, so rarely edited and not marked as advanced.

C9: set in the documentation examples, which type the anchor by hand, so the field stays visible. Hiding it would leave the mentions inserted from the dialog with no anchor; the fix is for the dialog to generate one and mark it advanced, see C3 and C8.

C13: a format, an HTML id with no space that is unique in the page, that the wiki macro cannot declare, see XWIKI-25197 in the Cross-macro findings: anchor="my anchor" is accepted and output as an invalid id, see E2.

C1: "The type of the mentioned actor." does not give the values to type, user being the only one in XWiki Standard, nor the default.

C2: optional.

C3: the field opens empty, which stands for "user", the value of every use in XWiki Standard. Nothing in the dialog shows it.

C4, minor: a free text field with one predefined value, user, that a select could offer, like the style of dashboard.

C5: in the Optional parameters tab, with two other fields.

C6: not set in the most common example, comes last in the tab.

C8: not advanced, while its only value in XWiki Standard is the default one and extensions are the only reason to change it.

C9: not shown in the examples, but meant to be extended by other extensions, so the field is not hidden.

C13: only a list of types is accepted, which the wiki macro cannot declare, see XWIKI-25197 in the Cross-macro findings: type="robot" is accepted and shows the raw reference, see E2.