chartjs

• ChartJS WebHome.xml: a wiki macro of the XAR, with a mandatory content that is put in the data-source attribute of a canvas, declares no inline support, and holds the JavaScript that draws the chart with Chart.js.
• Chart.js Integration: the legacy documentation page of both macros of the extension, the only documentation of the parameters.
• Table to ChartJS macro audit: the other macro of the extension, audited at the same time, whose ratings for what the two share are kept the same.

C1: "The chart data." does not say that the data is a JSON object with labels and datasets, which the dialog never describes, nor that each data set has a label and a list of numbers. The format is only visible in the examples of the documentation. To reproduce: open the Edit Macro dialog from Quick Actions.

C2: mandatory, since there is no chart without data and an empty content has no sensible meaning.

C4: a text area for a JSON text, the same field as the other macros with a data content, so a single text area is OK. It is edited only in the dialog, see E6.

C6: first of the dialog, with the focus, and set by the most common example.

C1, minor: "The type of chart. Choose from: line, bar, radar, pie, doughnut, polarArea, bubble, scatter." says what it sets and gives the values, but the list is presented as complete while the horizontalBar of the examples of the documentation works and is not in it, and the values are the Chart.js identifiers, written as is, with the case that matters, see E2.

C2: mandatory, while a default type, like bar, would work for any content of the documentation: {{chartjs}}{...}{{/chartjs}} would give a chart instead of the error "Parameter [type] is mandatory". Because of it, Quick Actions opens the Edit Macro dialog, see L1.

C4: a free text field, although the accepted values are a short list of chart types: a select, ideally with a preview of each type, could be used. type="abc" and type="Pie" are accepted and draw nothing, see E2.

C5: outside any group, with the content, so 2 fields, and the Optional parameters group comes after.

C6: second of the dialog, after the content, and set by the most common example.

C13: the accepted values are a list rather than a format, so it is recorded N/A: the select of C4 would declare them.

C1: "Advanced options specified as JSON. Checkout the Chart.js documentation for the available configuration options." gives the format and where the keys are listed. The keys that the macro adds, like backgroundColors, opacity, skipZeros, width and height, are in the long description, which the dialog does not show in full, and on the documentation page.

C3: the field opens empty, for the default options of Chart.js.

C4: a one line text field for a JSON object. A custom picker for this mini-syntax would be overkill, so the text field is OK, as long as the description explains the format, which it does.

C5: the 4 fields of the Optional parameters group, cssClass, id, options and title, with the content and type outside it, are not above 7.

C6: third of the group, in alphabetical order, visible without scrolling, and set by the most common example, so it is reachable.

C8: the description says "Advanced", but both examples of the documentation set options, including the most common one, a pie chart with backgroundColors, so the parameter is not rarely used and it stays visible. The word in the description is misleading but the measure is met.

C13: a JSON format that the macro cannot declare, since the parameters of a wiki macro cannot declare a format, see XWIKI-25197 in the Cross-macro findings. options="{" and options="abc" are accepted and ignored, see E2.

C1: "Additional CSS class to be added to the chart container. It can be useful in particular for setting the canvas dimensions at the CSS level." is a technical term for a styling hook, which another wording would only make more confusing. The name is the ID and the description is not translated in French and German.

C5: the 4 fields of the Optional parameters group, cssClass, id, options and title, with the content and type outside it, are not above 7.

C6: first of the group, not set by the most common example.

C8: a rarely used styling hook, not marked advanced.

C1, minor: "Chart title, added as aria-label to the generated canvas" uses developer terms, and the name suggests a title drawn on the chart, like the title of the Chart macro of XWiki Standard, while it is only the text alternative of the canvas, which no title is drawn from. The meaning is clear once read. The name is the ID and the description is not translated in French and German.

C3: the field opens empty, for no text alternative, the value of the most common example. A chart with no title has an img role and no name.

C5: the 4 fields of the Optional parameters group, cssClass, id, options and title, with the content and type outside it, are not above 7.

C6: last of the group, below the fold of the dialog, not set by the most common example.

C8: the only text alternative of a chart that screen readers cannot read, so it is not a rarely used parameter, even if the examples do not set it.

C1: "Chart identifier" is a technical term for a hook, the id of the canvas, which another wording would only make more confusing. The name is the ID and the description is not translated in French and German.

C5: the 4 fields of the Optional parameters group, cssClass, id, options and title, with the content and type outside it, are not above 7.

C6: second of the group, not set by the most common example.

C8: a rarely used hook, not marked advanced.

C13: an HTML id has no space and is unique in the page, a format that the macro cannot declare, since the parameters of a wiki macro cannot declare one, see XWIKI-25197 in the Cross-macro findings. id="my chart" is accepted and written on the canvas as given, an invalid id, see E2.