tagcloud

• TagCloudPageTest, xwiki-platform: the tests of the macro rendering.
• TagPlugin, xwiki-platform: how space and spaces select the pages, a space reference and its nested spaces, and the quoted format of spaces.

C1: "Space" is a technical term that the UI no longer shows since nested pages; the English name is the parameter ID, "space", which the dialog shows capitalized. The description does not say that the full reference of the page is needed, nor that its child pages are included: {{tagcloud space="TagcloudFixture"/}} shows "No tag has been added on this page or on its children" while {{tagcloud space="MacroAudit.TagcloudFixture"/}} shows its tags, and space="MacroAudit.TagcloudFixture.Team.WebHome" , the reference of the page, gives no tag either.

C3: the field opens empty, which stands for the whole wiki, as the description says, the value of the most common example.

C4: a plain text field for the page whose tags are shown, with its child pages, where a page picker could be used.

C6: the fields are in the order Limit, Space, Spaces, so the pages whose tags are shown come after the number of tags. The most common example sets none of them, so the order is OK per the measure.

C7: space and spaces are two ways to set the same feature, the pages whose tags are shown, but they are two separate fields, and setting both renders the error "Do not use "space" and "spaces" parameter in the same time".

C1: the description asks for space references "separated by comma "," and wrapped in single quotes "'"", a developer format, and uses "space", a term the UI no longer shows. A list without the quotes, like {{tagcloud spaces="MacroAudit.TagcloudFixture.Team"/}} , fails with a stack trace, see E2.

C4: a plain text field for a list of pages, where a page picker accepting several pages could be used.

C7: an alternative of space for several pages, shown as a separate field, see the notes of space.

C13: the value has a format, quoted space references separated by commas, which the macro cannot declare: it is a wiki macro, whose parameters cannot declare a range or a format, see XWIKI-25197 in the Cross-macro findings. spaces="Sandbox" is accepted by the dialog and fails at rendering, see E2.

C1, minor: the description does not say that an empty field shows every tag, nor which tags are kept, the most used ones. The French name and description are left in English, to fix on l10n.xwiki.org.

C3: the field opens empty, which stands for no limit, the value of the most common example.

C4: a plain text field for a number of tags, which a number field would fit, although the parameter is declared as an integer.

C13: the macro is a wiki macro, whose parameters cannot declare a range or a format, see XWIKI-25197 in the Cross-macro findings. limit="-3" is accepted and shows "No page has been tagged yet", while pages are tagged.