jira

• JIRAMacro.java, jira-11.1.7: the macro declares inline support but throws an error for the table and list styles inline, and has no translation resources for its name, description or parameters.
• Open JIRA project issues: JIRA-45 on the rendering in the editor, JIRA-37 on a default server, JIRA-80 on a server picker, JIRA-122 on the parsing of parameters.

C1: "The JIRA issues to retrieve" does not say what to type: one issue key per line when source is list, optionally followed by "|" and a note, or a JQL query when source is jql. To reproduce: open the Edit Macro dialog from Quick Actions.

C2: the content is mandatory, and no default would work: without issue keys or a query there is nothing to display.

C4, minor: a plain text area, for issue keys as well as a JQL query. For the list source, the default, an issue picker with suggestions from the server could be used; a JQL query needs a text area, but nothing helps writing it.

C3: no default is declared and the field opens empty. The URL of the most common example, https://jira.xwiki.org, is specific to each wiki, but no administration setting gives a default server for the wiki, see JIRA-37. The documentation recommends id instead, see the notes of id.

C5: URL and id, the server without which nothing renders, are in the second tab, "Instance", after the "Optional parameters" tab, which holds the display options.

C7: URL and id are two alternative ways to set the server and one of them is needed, but the "instance" group is a tab, not a feature, and neither is marked as required: the dialog submits {{jira}}XWIKI-2484{{/jira}} , which renders "No JIRA Server found. You must specify a JIRA server, using the "url" macro parameter or using the "id" macro parameter [...]".

C13: a URL, with no declared format: url="notaurl" is accepted and fails at rendering with "no protocol: notaurl".

Deprecated since version 8.3 of the extension, in favor of the labels of fields, and hidden from the Edit Macro dialog, so the criteria about its field do not apply. The probe lists it as a field not visible without scrolling: it is in the dialog, hidden.

C1: the description shows raw Javadoc markup to the user, "Format is {@code id1:label1!type1,id2:label2!type2}", and does not say which field ids and types exist. The name "Fields" is fine. To reproduce: open the Edit Macro dialog from Quick Actions.

C3: the field opens empty, which stands for the default fields of the style, type, key, summary, status and created for the default table style, but neither the field nor the description says which ones.

C4: a free text field for a list of JIRA fields in a dedicated syntax: a multi-select of the fields of the server, with an optional label, could be used.

C13: a list of id:label!type entries, with no declared format: fields=":::,," is accepted and renders nothing, with no message.

C1, minor: "the configuration id of the JIRA Server URL to use" does not say where these ids are defined, the JIRA configuration of the wiki administration, nor that it is the recommended way to set the server.

C3, minor: the field opens empty, which stands for no server and fails, even when the wiki defines a JIRA server: a single configured server is not preselected, see JIRA-37.

C4: a free text field, although the accepted values are the servers configured in the administration: a select of them could be used, see JIRA-80. id="noSuchInstance" is accepted and fails at rendering.

C5: in the second tab, "Instance", with URL, see the notes of URL.

C7: an alternative of URL, not grouped as a feature and not required, see the notes of URL.

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

C1: the label is the camelCase ID, "MaxCount", and the description, "the max number of JIRA issues to display", does not say what the preselected -1 means, the limit of the JIRA server.

C3: the field preselects the declared default, -1, the value of the most common example, but what it stands for is unclear, see C1.

C4: a plain text field for a number.

C13: a number, typed int, with no declared range, while only a positive number or -1 makes sense: maxCount="0" and maxCount="abc" are accepted and render an empty table, with no message.

C1: the name "Parameters" says nothing, and the description, "extra parameters for sources, displayers and field displayers", uses internal terms and gives neither the format, comma-separated name=value pairs, nor an example of a parameter, like field.url.label.

C3, minor: the field preselects "{}", the Java rendering of an empty set of properties, instead of an empty field.

C8: rarely used, for internal settings like the label of the url field, and set by no example of the documentation, but not marked as advanced.

C13: a list of name=value pairs, with no declared format: parameters="field.url.label='See';other=x" is accepted and ignored, see JIRA-122, and parameters="garbage" fails at rendering with "Cause: [null]".

C1, minor: "how JIRA issues are defined (e.g. "jql", "list")" does not say that it decides what the content holds, issue keys or a JQL query, and the "e.g." suggests other values while there are only two.

C4: a free text field, although the accepted values are list and jql: a select could be used. source="foo" is accepted and fails at rendering, see E2.

C6: the documentation sets it in three examples, but it comes fourth in the Optional parameters tab, after maxCount and parameters, which no example sets: the order is alphabetical.

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: the description, "how JIRA issues are displayed (e.g. "table", "list", "enum")", says what it sets; it does not say that only enum works inline, see E4.

C4: a free text field, although the accepted values are table, list and enum: a select could be used. style="foo" is accepted and fails at rendering, see E2.

C6: the documentation sets it in three examples, but it comes last in the Optional parameters tab, after maxCount and parameters, which no example sets: the order is alphabetical.

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