|
| Summary: |
Improve the names and descriptions of the wikimacrocontent and wikimacroparameter macros |
| Issue Type: |
 Improvement |
| Affects Versions: |
17.10.14, 18.8.0 |
| Assignee: |
Unassigned |
| Components: |
Rendering - WikiMacro |
| Created: |
22/Oct/26 11:59 |
| Priority: |
 Major |
| Reporter: |
Charpentier Lucas |
| Description: |
The names and descriptions of the wikimacrocontent and wikimacroparameter macros, and of their parameters, use the macro identifiers written in camel case and repeat the names, so a wiki macro author cannot tell where the macros work or what to type. The macros to change, with the file where most of the fix is done:
KOs covered
| Macro |
Criterion |
Parameters |
Problem |
| wikimacrocontent |
D1 wording |
|
"WikiMacro Content" is the macro ID spelled with capitals, and "WikiMacro" is the camel-case form of "wiki macro", the words the documentation and the editor use for this feature. A developer reads it, so technical words are fine, but the measure asks for no camelCase and "Put Footnotes" is the same kind of ID split into words. The French and German names are the English one. |
| wikimacrocontent |
D2 summary |
|
"Display editable content of a wikimacro." repeats the name and adds only "editable", and it spells "wikimacro" as one word. It does not say where the macro works. It does something only in the code of a wiki macro, where it shows the content the caller passes, and only when that content is of type Wiki, and on a normal page it renders nothing at all. The documentation says both, see L2. |
| wikimacroparameter |
D1 wording |
|
"WikiMacro Parameter" is the macro ID spelled with capitals, and "WikiMacro" is the camel-case form of "wiki macro", the words the documentation and the editor use for this feature. A developer reads it, so technical words are fine, but the measure asks for no camelCase, and "Put Footnotes" is the same kind of ID split into words. The French and German names are the English one. |
| wikimacroparameter |
D2 summary |
|
"Display editable parameter of a wikimacro." repeats the name and adds only "editable", and it spells "wikimacro" as one word. It does not say that the macro does something only in the code of a wiki macro, where it shows the value that the caller passes for the parameter, nor that the value is edited in place only for a parameter of type Wiki. On a normal page it renders nothing. |
| wikimacroparameter |
C1 clarity |
$content |
The Edit Macro dialog shows a Content field, named "Content" with no description in English, and the macro ignores any content: its class declares an optional content with DefaultContentDescriptor(false) and execute() never reads it. Text typed in it is lost silently, see E2. |
| wikimacroparameter |
C1 clarity |
name |
The field is called "name" and its description is "name", the ID repeated, in every language. It does not say that it is the name of a parameter of the wiki macro whose code holds the call, nor that an unknown name shows nothing. Technical terms are fine for a developer macro, but a description that says nothing is a KO, like the one of the id of attachmentGalleryPicker. |
Impact found on macro fluidity These 6 KOs come from the WYSIWYG usability audit of the macros, under the criteria C1 clarity, D1 wording, D2 summary 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. |
|
