|
| Description: |
The Edit Macro dialog of the JIRA macro puts the server, without which nothing renders, in the second tab, as two optional fields, URL and id, rather than as one required feature, sorts the optional fields alphabetically so the parameters of the examples come last, and preselects {} in the parameters field.
h2. KOs covered
||Macro||Criterion||Parameters||Problem||
|[jira|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/jira/]|C5 groups|{{URL}}|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.|
|[jira|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/jira/]|C5 groups|{{id}}|In the second tab, "Instance", with URL, see the notes of URL.|
|[jira|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/jira/]|C3 defaults|{{parameters}}|The field preselects "{}", the Java rendering of an empty set of properties, instead of an empty field.|
|[jira|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/jira/]|C8 advanced|{{parameters}}|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.|
|[jira|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/jira/]|C6 order|{{source}}|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.|
|[jira|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/jira/]|C6 order|{{style}}|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.|
|[jira|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/jira/]|C7 alternatives|{{URL}}|URL and id are two ways to set the server and one of them is needed, but the "Instance" group is a tab, not a feature, and neither is required: the dialog submits {{{{jira}}XWIKI-2484{{/jira}}}}, which renders "No JIRA Server found. You must specify a JIRA server [...]".|
|[jira|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/jira/]|C7 alternatives|{{id}}|An alternative of URL, not grouped with it as a feature and not required, see URL.|
h2. Impact found on macro fluidity
These 6 8 KOs come from the [WYSIWYG usability audit of the macros|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/], under the criteria C3 defaults, C5 groups, C6 order, C7 alternatives, C8 advanced of its [usability criteria|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Usability%20criteria/]. The page of each macro, linked in the table, has the full notes and the steps to reproduce. Fixing them means changing the parameter declarations of the macros: their features, groups, order, default values, mandatory and advanced flags. |
|
