Details
-
Improvement
-
Resolution: Unresolved
-
Major
-
None
-
8.4.1
-
None
-
Unknown
-
Description
The description of the FAQ macro restates its name and misses the rule a user needs to insert it, and the macro has no category, so it appears in no category of the Insert Macro dialog.
KOs covered
| Macro | Criterion | Parameters | Problem |
|---|---|---|---|
| faq | D2 summary | "Lists FAQ entries" restates the name with a verb. It does not say that the entries are shown in a table the reader can sort and filter, and it misses a rule the user needs to insert the macro: only the entries of the space given in the filter are listed, so without a filter the macro lists nothing, see I2. The French and German descriptions are left in English. | |
| faq | D3 category | The macro has no category: the macro list gives it an empty category, so it appears in no category of the Insert Macro dialog. Like documents and liveData, the other macros that list data, it belongs in Content, where a user looking for a list of entries would look. |
Impact found on macro fluidity
These 2 KOs come from the WYSIWYG usability audit of the macros, under the criteria D2 summary, D3 category of its usability criteria. The page of each macro, linked in the table, has the full notes and the steps to reproduce. Fixing them means changing the translations of the macros and, for a name or a category, their definitions.