displayIcon

• DisplayIconMacroParameters, xwiki-platform: name is a mandatory String, iconSet a String and fallback a boolean, true by default and advanced, with no constraint.
• Add an Icon Using the WYSIWYG Editor: the dedicated "Icon" Quick Action, which inserts the macro from an icon picker.
• IconManagerScriptService, xwiki-platform: $services.icon.render generates the macro call, with iconSet and fallback.

C1, minor: the description says what the parameter does, but uses "icon set" for the Icon Theme, see iconSet, and "the default icon set" without saying which one it is, Silk, nor that with false nothing is displayed.

C3: the checkbox is checked, the declared default true.

C4: a checkbox, which fits a boolean.

C8: marked as advanced, and the most common example does not set it.

C9: no example of the documentation sets it, but displaying nothing rather than an icon of another Icon Theme is a realistic use, and the icon script service of XWiki, $services.icon.render(name, iconSet, fallback), exposes it to scripts.

C13: N/A, a boolean.

C1: the description "The name of the icon set." uses "icon set", the historical name of what the administration and the documentation call an Icon Theme, and it does not say that an empty value takes the Icon Theme configured for the wiki, nor that the value "default" selects the Icon Theme XWiki falls back to. The German "Der Name des Icon Sets." has the same problem.

C3: the field opens empty, which stands for the Icon Theme of the wiki, the value used in most cases, like the empty language of code; the description does not explain it, see C1.

C4: a free text field, although the accepted values are the Icon Themes installed on the wiki, like "Font Awesome" and "Silk": a wrong or lowercase name, like "silk", is accepted silently, see E2. A select of the installed Icon Themes could be used.

C8, minor: taking an icon from another Icon Theme than the one of the wiki is rare, the XWiki pages that use the macro never set it outside the tests, but the field is not marked as advanced.

C9: the documentation has an example that sets it, {{displayIcon name="home" iconSet="Silk"/}} .

C13: N/A, the accepted values are a list of Icon Themes, not a range or a format; the missing select is counted under C4.

C1: the description "The name of the icon." only repeats the field name: it does not say that the name is one of the XWiki Icon Set, like "home" or "add", nor where to find the list.

C2: mandatory with no default, which is right: the icon to display is the whole purpose of the macro.

C4: a plain text field, so the user has to know the icon names of the XWiki Icon Set: {{displayIcon name="fa-home"/}} or a typo gives nothing, see E2. An icon picker with previews already exists, the one of the dedicated "Icon" Quick Action, and the Icon Picker widget: the dialog could use it.

C13: N/A, the accepted values are a list of icon names, not a range or a format; the missing picker is counted under C4.

C5: three fields, Name outside any group and the two others in the Optional parameters tab.

C6: Name, the only parameter set in the most common example, comes first.