|
| Description: |
When the office macro is inserted from the Quick Actions menu, an office macro call with no parameter is added to the page right away and renders an error box, since it has no document to show. The include and display macros, which also show the content of a target, declare their target as mandatory, so the Quick Action opens the Edit Macro dialog with the target field to fill first. The office macro declares neither reference nor attachment as mandatory, since it needs one of the two.
h2. KOs covered
||Macro||Criterion||Problem||
|[office|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/office/]|L1 consistency|No mandatory parameter, unlike include and display, so the Quick Action inserts an empty call that renders an error box.|
|[office|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/office/]|I2 zero-config|Quick Actions, and the Edit Macro dialog submitted with the default values, insert {{{{office/}}}}, which renders an error box in the editor and in view mode: the office server error on a fresh XWiki Standard, or "You must specify the 'reference' parameter pointing to the office file to display." The user is never asked for the file first.|
h2. Impact found on macro fluidity
This KO comes These 2 KOs come from the [WYSIWYG usability audit of the macros|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/], under the criterion criteria L1 consistency and I2 zero-config of its [usability criteria|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Usability%20criteria/], which checks that a macro behaves like the other macros of the same kind for the mandatory content, the insertion process and its default parameter values. The [page of the macro|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/office/] has the full notes, and the [L1 consistency table|https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Documentation%20status/#HL1consistency] tracks the progress on this criterion. |
|
