velocity

• Velocity macro source code: the filters are the components none, indent and html.
• GitHub code search of the xwiki organization: plain {{velocity}} is the most frequent call, then {{velocity output="false"}} .

C1: the name "Content" and the description "the velocity script to execute" are clear for a developer macro.

C2: the content is mandatory, which is right, an empty script does nothing.

C4: a plain text area in the Edit Macro dialog, counted under E6.

C6: the content comes first, before the optional parameters.

C1: the description "indicate which filtering mode to use" gives no possible value for a free field, and does not say what a filter does or that an empty value stands for the default configured in the wiki, indent unless changed. The valid values, none, indent and html, are in no description, and the documentation only mentions indent. The name is the ID.

C3: the empty field stands for the filtering mode configured for the wiki, indent by default, which is OK for a value that comes from the wiki setting, with C1 asking for the explanation. The documentation says the default is indent, and the macro declares none.

C4: a free text field for a fixed list of three filters, a select could offer them. A wrong value is accepted silently, see E2.

C8: a rarely used parameter, no example of the common use sets it and none of the XWiki Standard calls found sets it, but it is not marked as advanced.

C1: the name is the ID, and the description with its examples is clear for a developer macro. It says "List of JARs" without saying how to separate several values.

C3: empty means no extra JAR, which is the right default.

C4: a free text field for attachment references or URLs, with no picker, and it is accepted silently when the attachment does not exist, see E2. The values are free text, so the KO is minor.

C8: a rarely used parameter, not set by any example nor by the XWiki Standard calls found, and not marked as advanced.

C9: inherited from the script macros and not documented for velocity: a user does not expect to add JARs to the class loader of a Velocity script, which is mostly a groovy need, so the field is only noise in the dialog.

C13: a list of references in a single field with the separator undeclared: "a.jar, b.jar" is refused with "Failed to add JAR URLs to the current class loader" and the description does not say which separator to use.

C1: the description "Specifies whether the output result should be inserted back in the page" is understandable for a developer macro. The English name is the ID, "output".

C3: the checkbox preselects the default, true.

C4: a checkbox for a boolean.

C6: no common example sets it, and it is visible in the group with only three other fields.

C8: output="false" is used by about one call out of ten in XWiki Standard, for scripts that only set variables, so it is not rarely used.

C9: realistic use, the examples of the documentation of the script macros set it.

C1: the description "Specifies whether wiki syntax in the script execution result will be rendered or not" is clear for a developer macro. The English name is the ID, "wiki".

C3: the checkbox preselects the default, true.

C4: a checkbox for a boolean.

C8, minor: wiki="false" is a realistic but rare use, found once in the XWiki Standard calls, and the field is not marked as advanced.

C9: realistic use, for a script that outputs text with wiki characters.